Describe images,or answer questions about them.

import os, requests
from pathlib import Path

resp = requests.post(
    "https://api.msightflow.ai/v1/describe",
    headers={"Authorization": f"Bearer {os.environ['MSF_API_KEY']}"},
    files={"image": Path("product.jpg").read_bytes()},
    data={"mode": "caption", "provider": "blip"},
)
print(resp.json()["caption"])
# → "a pair of red sneakers on a wooden floor"

# VQA mode — ask a specific question.
resp = requests.post(
    "https://api.msightflow.ai/v1/describe",
    headers={"Authorization": f"Bearer {os.environ['MSF_API_KEY']}"},
    files={"image": Path("warehouse.jpg").read_bytes()},
    data={
        "mode": "vqa",
        "question": "How many people are wearing hard hats?",
        "provider": "cloud",
        "model": "gpt-4o",
    },
)
print(resp.json()["answer"])
# → "Three people are wearing hard hats."

# Structured extraction — pass a JSON schema.
resp = requests.post(
    "https://api.msightflow.ai/v1/describe",
    headers={"Authorization": f"Bearer {os.environ['MSF_API_KEY']}"},
    files={"image": Path("listing.jpg").read_bytes()},
    data={
        "mode": "vqa",
        "question": "Describe this product listing for an e-commerce catalogue.",
        "provider": "cloud",
        "model": "gpt-4o",
        "output_schema": '''{
            "title": "string",
            "main_colour": "string",
            "material": "string",
            "size_label": "string",
            "alt_text": "string"
        }''',
    },
)
print(resp.json()["structured"])
# → {"title": "Red sneakers", "main_colour": "red", "material": "canvas", ...}

import fetch from "node-fetch";
import FormData from "form-data";
import fs from "fs";

const form = new FormData();
form.append("image", fs.createReadStream("product.jpg"));
form.append("mode", "caption");

const resp = await fetch("https://api.msightflow.ai/v1/describe", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.MSF_API_KEY}` },
  body: form,
});
const { caption } = await resp.json();
console.log(caption);