Generación de imágenes

POST /v1/images/generations

Compatible con OpenAI images.generate SDK. Los parámetros específicos del proveedor conviven con los estándar: el backend transmite lo que entiende cada modelo.

Parámetros comunes

Ejemplo 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 respuesta

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

Variante de transmisión

Aprobar sse: true al realizar proxy a través de middleware que tiene tiempos de inactividad ajustados. La respuesta es un evento SSE con el JSON completo, luego [DONE].

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

data: [DONE]

Imagen a imagen y referencia

Modelos con image_caps.max_input_images > 0 aceptar imágenes de referencia. Pase URL o datos codificados en 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"}
    ]
  }'

Edición de imágenes

El endpoint de edición compatible con OpenAI. Envía la imagen de origen como archivo multipart, como hacen los SDK de OpenAI con images.edit, o envía el cuerpo JSON mostrado arriba con input_images. Sigue el mismo camino que /v1/images/generations: los mismos modelos, precios y formato de respuesta.

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)

Hasta 16 imágenes de entrada por solicitud, de 25 MB cada una; el límite propio del modelo es image_caps.max_input_images. Una solicitud sin imagen de entrada se rechaza con 400 en lugar de convertirse en una llamada de texto a imagen. Cada imagen de entrada puede aumentar el precio, como indica la página del modelo.

Parámetros específicos del modelo

Más allá de los parámetros comunes anteriores, las familias de modelos individuales aceptan extras. Los parámetros desconocidos se envían al canal ascendente tal cual, por lo que cualquier mando específico del proveedor futuro también funcionará sin una actualización del SDK.

Nano-Banana

nano-banana-2, nano-banana-pro

Suno (music)

suno-v4.5, suno-v5 y suno-v5.5 se aceptaban históricamente en este endpoint. Ahora pertenecen a la API de música nativa en /v1/audio/music — las llamadas aquí se rechazan con `wrong_endpoint`.

Descubriendo capacidades

Cada modelo de imagen expone image_caps en /v1/models para que los clientes puedan validar las entradas antes de enviar:

Los precios de imagen no están en image_caps — usa los campos de precio del modelo en /v1/models para el coste.