Formato de transición heredado

Esta sección documenta la antigua estructura de petición compatible con Nano Banana que se usaba anteriormente en la documentación de modelos. Se mantiene solo para la transición. Las nuevas integraciones deberían usar las páginas de modelos compatibles con OpenAI y la Referencia de API.

Endpoints heredados

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

Campos heredados

Campo	Reemplazo	Notas
num	n	Número de imágenes de salida.
image_size	size	La forma de salida de Gemini ahora usa valores de relación de aspecto como 1:1; los tamaños en píxeles dependen del proveedor.
URL JSON image	URL JSON image	La documentación nueva de edición usa POST /v1/images/edits; archivos, uploads multipart e imágenes base64 no están soportados.
Respuesta data.url	Respuesta data[0].url	Las respuestas nuevas siguen la forma de respuesta de imagen de OpenAI.

Ejemplo de generación heredado

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"
  }'

Ejemplo de edición heredado

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
  }'

Respuesta heredada

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

Cuando num es mayor que 1, las respuestas heredadas pueden devolver data.url como un array.