Generazione di immagini

POST /v1/images/generations

Drop-in compatibile con OpenAI images.generate SDK. I parametri specifici del provider convivono insieme a quelli standard: il backend inoltra ciò che comprende ciascun modello.

Parametri comuni

Esempio di base

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 della risposta

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

Variante in streaming

Passaggio sse: true durante l'inoltro tramite middleware con timeout di inattività ridotti. La risposta è quindi un evento SSE con il JSON completo [DONE].

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

data: [DONE]

Immagine per immagine e riferimento

Modelli con image_caps.max_input_images > 0 accettare immagini di riferimento. Passa URL o dati con codifica 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"}
    ]
  }'

Modifica immagini

L’endpoint di modifica compatibile con OpenAI. Invia l’immagine di partenza come file multipart, come fanno gli SDK OpenAI per images.edit, oppure invia il corpo JSON mostrato sopra con input_images. Segue lo stesso percorso di /v1/images/generations: stessi modelli, prezzi e formato di risposta.

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)

Fino a 16 immagini di input per richiesta, 25 MB ciascuna; il limite del modello è image_caps.max_input_images. Una richiesta senza immagine di input viene rifiutata con 400 invece di diventare una chiamata testo-immagine. Ogni immagine di input può aumentare il prezzo, come indicato nella pagina del modello.

Parametri specifici del modello

Oltre ai parametri comuni di cui sopra, le singole famiglie di modelli accettano extra. I parametri sconosciuti vengono inoltrati all'upstream così come sono, quindi qualsiasi futura manopola specifica del provider funzionerà anche senza un aggiornamento dell'SDK.

Nano-Banana

nano-banana-2, nano-banana-pro

Suno (music)

suno-v4.5, suno-v5 e suno-v5.5 erano storicamente accettati su questo endpoint. Ora appartengono all’API musicale nativa su /v1/audio/music — le chiamate qui vengono rifiutate con `wrong_endpoint`.

Alla scoperta delle capacità

Ogni modello di immagine espone image_caps SU /v1/models in modo che i client possano convalidare gli input prima di inviare:

Il prezzo delle immagini non è in image_caps — usa i campi di prezzo del modello su /v1/models per il costo.