Bild-Generierung

POST /v1/images/generations

Direkt kompatibel mit dem OpenAI images.generate SDK. Provider-spezifische Parameter laufen neben den Standard-Parametern — das Backend leitet weiter was jedes Modell versteht.

Gemeinsame Parameter

Einfaches Beispiel

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

Response-Format

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

Streaming-Variante

Übergib sse: true wenn du durch Middleware mit knappen Idle-Timeouts proxied. Die Response ist ein einzelnes SSE-Event mit dem kompletten JSON, dann [DONE].

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

data: [DONE]

Bild-zu-Bild & Referenz

Modelle mit image_caps.max_input_images > 0 akzeptieren Referenz-Bilder. Übergib entweder URLs oder base64-codierte Daten.

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

Bildbearbeitung

Der OpenAI-kompatible Edit-Endpunkt. Sende das Ausgangsbild als Multipart-Datei, so wie es die OpenAI-SDKs für images.edit tun, oder den oben gezeigten JSON-Body mit input_images. Er läuft über denselben Weg wie /v1/images/generations: dieselben Modelle, Preise und dasselbe Antwortformat.

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)

Bis zu 16 Eingabebilder pro Anfrage, je 25 MB; das Limit des Modells steht in image_caps.max_input_images. Eine Anfrage ohne Eingabebild wird mit 400 abgelehnt, statt zu einem Text-zu-Bild-Aufruf zu werden. Jedes Eingabebild kann den Preis erhöhen, wie auf der Modellseite angegeben.

Modell-spezifische Parameter

Über die gemeinsamen Parameter oben hinaus akzeptieren einzelne Modell-Familien Extras. Unbekannte Parameter werden ungeprüft an den Upstream weitergeleitet, sodass auch zukünftige provider-spezifische Knöpfe ohne SDK-Update funktionieren.

Nano-Banana

nano-banana-2, nano-banana-pro

Suno (music)

suno-v4.5, suno-v5 und suno-v5.5 wurden auf diesem Endpoint früher akzeptiert. Sie gehören jetzt zur nativen Musik-API unter /v1/audio/music — Aufrufe hier werden mit `wrong_endpoint` abgewiesen.

Capabilities entdecken

Jedes Bild-Modell exponiert image_caps auf /v1/models damit Clients Inputs vor dem Senden validieren können:

Die Bildpreise stehen nicht in image_caps — verwenden Sie die Preisfelder des Modells unter /v1/models für die Kosten.