Geração de imagens

{
  "models": [
    { "id": "gpt-image-2", "label": "GPT Image 2", "description": "…",
      "provider": "openai", "supports_references": true,
      "sizes": ["1024x1024", "1536x1024", "1024x1536"],
      "qualities": ["draft", "standard", "high"],
      "formats": ["png", "jpg", "webp"], "default": true }
  ],
  "default": "gpt-image-2",
  "style_presets": [ { "id": "fotografia-editorial-realista", "label": "…", "description": "…" } ],
  "aspects": ["square", "portrait", "landscape"],
  "qualities": ["draft", "standard", "high"],
  "formats": ["png", "jpg", "webp"],
  "max_images": 4,
  "max_references": 4
}

{
  "model": "gpt-image-2",
  "prompt": "capa editorial sobre controle fiscal para MEI",
  "aspect": "landscape",
  "size": "1536x1024",
  "quality": "high",
  "output_format": "png",
  "n": 1,
  "style_preset": "fotografia-editorial-realista",
  "brand": { "colors": ["#0FA958", "#181818"], "tone": ["confiável", "direto"] },
  "reference_images": [{ "b64": "…" }, { "url": "https://…" }],
  "enhance_prompt": true,
  "include_b64": true
}

{
  "id": "…", "model_used": "gpt-image-2", "provider": "openai",
  "prompt": "capa editorial sobre controle fiscal para MEI",
  "revised_prompt": "capa editorial … ; photorealistic professional quality; no text, no logos; …",
  "enhanced": true,
  "aspect": "landscape", "size": "1536x1024", "quality": "high", "output_format": "png",
  "style_preset": "fotografia-editorial-realista",
  "brand": { "colors": ["#0FA958"], "tone": ["confiável"] },
  "n": 1, "reference_count": 0, "key_source": "vault",
  "usage": { "input_tokens": 22, "output_tokens": 1568, "total_tokens": 1590 },
  "duration_ms": 41230, "created_at": "2026-07-27T22:15:00Z",
  "images": [
    { "b64_json": "…", "url": "https://…assinada…", "asset_id": "…",
      "mime_type": "image/png", "byte_size": 1284339 }
  ]
}

event: prompt
data: {"final_prompt":"um cubo vermelho…; photorealistic professional quality…","original_prompt":"um cubo vermelho","enhanced":true,"model":"gpt-image-2","size":"1024x1024","quality":"medium","output_format":"png","mime_type":"image/png","partials_expected":3}

event: partial
data: {"index":0,"total":3,"b64_json":"iVBORw0KGgo…"}

event: done
data: {"id":"d6455bd0-…","model_used":"gpt-image-2","size":"1024x1024","images":[{"url":"https://…assinada…","asset_id":"…","mime_type":"image/png"}]}

curl -N -X POST https://agents-api.catcher.one/v1/images/generations/stream \
  -H "X-API-Key: ctc_sua_chave" \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"um cubo azul sobre fundo branco","quality":"draft","n":1,"include_b64":false}'

const res = await fetch('https://agents-api.catcher.one/v1/images/generations/stream', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.CATCHER_API_KEY!, 'Content-Type': 'application/json' },
  body: JSON.stringify({ prompt: 'um cubo azul sobre fundo branco', n: 1, include_b64: false }),
})
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`)

const reader = res.body!.getReader()
const decoder = new TextDecoder()
let buffer = ''

for (;;) {
  const { done, value } = await reader.read()
  if (done) break
  buffer += decoder.decode(value, { stream: true })

  // Os frames são separados por linha em branco. Guarde o resto: um frame de
  // ~1,5 MB chega em vários chunks e cortá-lo cedo quebra o JSON.
  const frames = buffer.split('\n\n')
  buffer = frames.pop() ?? ''

  for (const frame of frames) {
    const evLine = frame.split('\n').find((l) => l.startsWith('event:'))
    const dataLine = frame.split('\n').find((l) => l.startsWith('data:'))
    if (!evLine || !dataLine) continue
    const event = evLine.slice(6).trim()
    const data = JSON.parse(dataLine.slice(5).trim())

    if (event === 'prompt') console.log('prompt final:', data.final_prompt)
    if (event === 'partial') render(`data:${'image/png'};base64,${data.b64_json}`)
    if (event === 'done') console.log('pronto:', data.images[0].url)
    if (event === 'error') throw new Error(`${data.error_code}: ${data.message}`)
  }
}

import json, requests

with requests.post(
    "https://agents-api.catcher.one/v1/images/generations/stream",
    headers={"X-API-Key": API_KEY},
    json={"prompt": "um cubo azul sobre fundo branco", "n": 1, "include_b64": False},
    stream=True, timeout=300,
) as res:
    res.raise_for_status()
    event = None
    for line in res.iter_lines(decode_unicode=True):
        if line is None or line == "":
            continue
        if line.startswith("event:"):
            event = line.split(":", 1)[1].strip()
        elif line.startswith("data:"):
            data = json.loads(line[5:].strip())
            if event == "prompt":
                print("prompt final:", data["final_prompt"])
            elif event == "partial":
                print("rascunho", data["index"] + 1, "de", data["total"])
            elif event == "done":
                print("pronto:", data["images"][0]["url"])
            elif event == "error":
                raise RuntimeError(f'{data["error_code"]}: {data["message"]}')