TokenLab
API-Schlüssel erhalten
DokumentationAPI-ReferenzIntegrationen

Bilder

Bildvariation erstellen

Erstellt eine Variation eines gegebenen Bildes

POST
/v1/images/variations

Übersicht

Dieser Endpunkt bleibt für legacy OpenAI-kompatible Variations-Clients erhalten. Für aktuelle Image-to-Image-Workflows ist er nicht empfohlen; verwenden Sie nach Möglichkeit /v1/images/edits mit gpt-image-2 oder /v1/images/generations mit einem Image-to-Image-Modell wie nano-banana-pro. Erfordert multipart/form-data.

Anfragekörper

Timeout für synchrone Anfragen: Einige geroutete Bildanbieter geben das endgültige Bild inline zurück und warten dafür, bis die Generierung abgeschlossen ist. Hochauflösende oder hochwertige Anfragen können fast eine Minute oder länger dauern; setzen Sie das Timeout Ihres HTTP-Clients daher auf mindestens 120s. Wenn die Create-Antwort status: "pending", task_id oder poll_url enthält, folgen Sie stattdessen der zurückgegebenen poll_url.

imagefileerforderlich

Multipart-Ausgangsbild. Datei und vollständiger Anfragekörper dürfen jeweils 50 MiB nicht überschreiten. Formate und Abmessungen hängen vom Modell ab; dessen aktuelle Details müssen /v1/images/variations ausdrücklich aufführen.

modelstringerforderlich

Erforderliche Modell-ID für legacy variationskompatible Routen. Es gibt keinen impliziten Standard; für aktuelle Image-to-Image-Workflows bevorzugen Sie /v1/images/edits oder /v1/images/generations mit einem aktuellen Modell.

nintegerStandard: 1

Anzahl der zu generierenden Bilder (1-10, modellabhängig).

sizestring

Die Größe der erzeugten Bilder für legacy variationskompatible Routen. Unterstützte Werte hängen vom ausgewählten Modell ab.

response_formatstring

Das Format der zurückgegebenen Bilder. Muss url oder b64_json sein.

userstring

Eine eindeutige Kennung für Ihren Endbenutzer zur Missbrauchsüberwachung.

Antwort

createdinteger

Unix-Zeitstempel der Bilderstellung.

dataarray

Array der generierten Bildvariationen.

Jedes Objekt enthält:

  • url (string): URL des Variationsbildes (wenn response_format url ist)
  • b64_json (string): Base64-kodiertes Bild (wenn response_format b64_json ist)

Anfrage

curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-legacy-variation-model" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

Antwort

Antwort
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Hinweise

Dies ist ein legacy Kompatibilitätsendpunkt. Er ist nicht im aktuellen empfohlenen Bildmodellkatalog enthalten. Für neue Integrationen verwenden Sie /v1/images/edits mit gpt-image-2 oder /v1/images/generations mit operation: "image-to-image" und einem aktuellen Image-to-Image-Modell.

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Header

X-TokenLab-Delivery-Policy?string

Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.

Zulässige Werte

  • "auto"
  • "verified"
  • "official"

Anfragekörper

multipart/form-data

Antwort

application/json

application/json

application/json

application/json

application/json

application/json

Bild bearbeiten

Zurück

Bildstatus abrufen

Weiter