Formato de transição legado

Esta seção documenta o formato de requisição compatível com Nano Banana mais antigo que era usado anteriormente na documentação do modelo. É mantido apenas para transição. Novas integrações devem usar as páginas de modelos compatíveis com OpenAI e a Referência da API.

Endpoints legados

POST /v1/images/generate
POST /v1/images/edit

Campos legados

Campo	Substituto	Notas
num	n	Número de imagens de saída.
image_size	size	O formato de saída Gemini agora usa valores de proporção como 1:1; tamanhos em pixels são específicos do provedor.
URL image em JSON	URL image em JSON	A nova documentação de edição usa POST /v1/images/edits; arquivos, uploads multipart e imagens base64 não são suportados.
Resposta data.url	Resposta data[0].url	As novas respostas seguem o formato de resposta de imagem da OpenAI.

Exemplo de geração legado

curl https://api.pixapi.ai/v1/images/generate \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "Editorial product photo of a matte black water bottle on stone",
    "num": 1,
    "image_size": "1:1"
  }'

Exemplo de edição legado

curl https://api.pixapi.ai/v1/images/edit \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "Change the bottle color to warm ivory and keep the background",
    "image": "https://example.com/input.png",
    "num": 1
  }'

Resposta legada

{
  "code": 0,
  "message": "ok",
  "data": {
    "url": "https://cdn.pixapi.ai/generated/image.png"
  }
}

Quando num é maior que 1, respostas legadas podem retornar data.url como um array.