Beeldgeneratie

POST /v1/images/generations

Drop-in compatibel met de OpenAI images.generate SDK. Provider-specifieke parameters leven naast de standaardparameters: de backend geeft door wat elk model begrijpt.

Gemeenschappelijke parameters

Eenvoudig voorbeeld

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

Reactie vorm

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

Streaming-variant

Doorgang sse: true bij proxying via middleware met krappe time-outs voor inactiviteit. Het antwoord is dan één SSE-gebeurtenis met de volledige JSON [DONE].

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

data: [DONE]

Afbeelding-naar-afbeelding en referentie

Modellen met image_caps.max_input_images > 0 accepteer referentieafbeeldingen. Geef URL's of base64-gecodeerde gegevens door.

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

Afbeeldingen bewerken

Het OpenAI-compatibele edit-endpoint. Stuur de bronafbeelding als multipart-bestand, zoals de OpenAI-SDK’s doen voor images.edit, of stuur de JSON-body van hierboven met input_images. Het volgt hetzelfde pad als /v1/images/generations: dezelfde modellen, prijzen en hetzelfde antwoordformaat.

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)

Tot 16 invoerafbeeldingen per verzoek, elk 25 MB; de eigen limiet van het model staat in image_caps.max_input_images. Een verzoek zonder invoerafbeelding wordt met 400 geweigerd in plaats van een tekst-naar-afbeelding-aanroep te worden. Elke invoerafbeelding kan de prijs verhogen, zoals op de modelpagina staat.

Modelspecifieke parameters

Naast de bovenstaande gemeenschappelijke parameters accepteren individuele modelfamilies extra's. Onbekende parameters worden as-is doorgestuurd naar de upstream, dus elke toekomstige providerspecifieke knop werkt ook zonder SDK-update.

Nano-Banana

nano-banana-2, nano-banana-pro

Suno (music)

suno-v4.5, suno-v5 en suno-v5.5 werden hier historisch geaccepteerd. Ze horen nu bij de native muziek-API op /v1/audio/music — aanroepen hier worden geweigerd met `wrong_endpoint`.

Mogelijkheden ontdekken

Elk beeldmodel legt bloot image_caps op /v1/models zodat klanten de invoer kunnen valideren voordat ze het volgende verzenden:

Image-prijzen staan niet op image_caps — gebruik de prijsvelden van het model op /v1/models voor de kosten.