Bilder

Bildvariation erstellen

Erstellt eine Variation eines angegebenen Bildes

POST
/v1/images/variations

Übersicht

Dieser Endpunkt unterstützt bestehende OpenAI-Variations-Clients. Für neue Image-to-Image-Funktionen verwenden Sie /v1/images/edits oder /v1/images/generations mit einem aktuellen Image-to-Image-Modell. Anfragen verwenden multipart/form-data.

Request-Body

Dieser Endpunkt ist synchron: Die Antwort enthält das finale Bild und niemals einen Task. Setzen Sie das Timeout Ihres HTTP-Clients auf mindestens 120s.

imagefileerforderlich

Multipart-Quellbild. Die Datei und der gesamte Request-Body dürfen jeweils maximal 50 MiB groß sein (größere Uploads geben 413 zurück). Unterstützte Formate und Abmessungen hängen vom gewählten Modell ab. Es werden nur Modelle akzeptiert, deren Details image-to-image auf /v1/images/variations abbilden; jedes andere Modell gibt 400 zurück.

modelstringerforderlich

Modell-ID. Dieser Endpunkt hat kein Standardmodell. Die Beispiele verwenden den Platzhalter your-legacy-variation-model: Ersetzen Sie ihn durch ein Modell, in dessen Details dieser Endpunkt aufgeführt ist.

nintegerStandard: 1

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

sizestring

Größe des generierten Bildes. Unterstützte Werte hängen vom gewählten Modell ab.

response_formatstring

Das Format, in dem die generierten Bilder zurückgegeben werden. Muss url oder b64_json sein.

userstring

Eine eindeutige Kennung, die Ihren Endbenutzer für das Missbrauchs-Monitoring repräsentiert.

Antwort

createdinteger

Unix-Zeitstempel des Zeitpunkts, zu dem die Bilder erstellt wurden.

dataarray

Array von generierten Bildvariationen.

Jedes Objekt enthält:

  • url (string): URL des Variationsbildes (wenn response_format url ist)
  • b64_json (string): Base64-codiertes 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

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

Hinweise

Dies ist ein Legacy-Kompatibilitätsendpunkt. Er ist nicht im aktuellen empfohlenen Bildmodellkatalog enthalten. Verwenden Sie für neue Integrationen /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

application/json

application/json