Geração de imagem

POST /v1/images/generations

Drop-in compatível com OpenAI images.generate SDK. Os parâmetros específicos do provedor convivem com os padrões – o backend encaminha o que cada modelo entende.

Parâmetros comuns

Exemplo básico

curl https://api.airforce/v1/images/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "A cute baby sea otter floating on its back",
    "n": 1,
    "response_format": "url"
  }'

Forma de resposta

{
  "created": 1715000000,
  "data": [{
    "url": "https://.../image.jpeg"
  }]
}

Variante de streaming

Passar sse: true ao fazer proxy por meio de middleware com tempos limite de inatividade reduzidos. A resposta é um evento SSE com o JSON completo, então [DONE].

data: {"created":1715000000,"data":[{"url":"https://.../image.jpeg"}]}

data: [DONE]

Imagem a imagem e referência

Modelos com image_caps.max_input_images > 0 aceitar imagens de referência. Passe URLs ou dados codificados em base64.

curl https://api.airforce/v1/images/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "Same character, now in a snowy forest",
    "aspect_ratio": "16:9",
    "input_images": [
      {"url": "https://example.com/character.jpg"}
    ]
  }'

Edição de imagens

O endpoint de edição compatível com OpenAI. Envie a imagem de origem como arquivo multipart, como os SDKs da OpenAI fazem em images.edit, ou envie o corpo JSON mostrado acima com input_images. Ele segue o mesmo caminho de /v1/images/generations: mesmos modelos, preços e formato de resposta.

curl https://api.airforce/v1/images/edits \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -F "model=nano-banana-2" \
  -F "prompt=Same character, now in a snowy forest" \
  -F "[email protected]" \
  -F "aspect_ratio=16:9"

from openai import OpenAI

client = OpenAI(base_url="https://api.airforce/v1", api_key="sk-air-YOUR_API_KEY")

with open("character.png", "rb") as image:
    result = client.images.edit(
        model="nano-banana-2",
        image=image,
        prompt="Same character, now in a snowy forest",
    )
print(result.data[0].url)

Até 16 imagens de entrada por requisição, 25 MB cada; o limite do próprio modelo é image_caps.max_input_images. Uma requisição sem imagem de entrada é recusada com 400 em vez de virar uma chamada de texto para imagem. Cada imagem de entrada pode aumentar o preço, conforme a página do modelo.

Parâmetros específicos do modelo

Além dos parâmetros comuns acima, famílias de modelos individuais aceitam extras. Parâmetros desconhecidos são encaminhados para o upstream como estão, portanto, qualquer botão futuro específico do provedor também funciona sem uma atualização do SDK.

Nano-Banana

nano-banana-2, nano-banana-pro

Suno (music)

suno-v4.5, suno-v5 e suno-v5.5 eram historicamente aceites neste endpoint. Agora pertencem à API de música nativa em /v1/audio/music — as chamadas aqui são rejeitadas com `wrong_endpoint`.

Descobrindo capacidades

Cada modelo de imagem expõe image_caps sobre /v1/models para que os clientes possam validar as entradas antes de enviar:

O preço das imagens não está em image_caps — usa os campos de preço do modelo em /v1/models para o custo.