Bilder
Bildvariation erstellen
Erstellt eine Variation eines angegebenen Bildes
Ü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.
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.
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.
1Anzahl der zu generierenden Bilder (1–10, modellabhängig).
Größe des generierten Bildes. Unterstützte Werte hängen vom gewählten Modell ab.
Das Format, in dem die generierten Bilder zurückgegeben werden. Muss url oder b64_json sein.
Eine eindeutige Kennung, die Ihren Endbenutzer für das Missbrauchs-Monitoring repräsentiert.
Antwort
Unix-Zeitstempel des Zeitpunkts, zu dem die Bilder erstellt wurden.
Array von generierten Bildvariationen.
Jedes Objekt enthält:
url(string): URL des Variationsbildes (wenn response_formaturlist)b64_json(string): Base64-codiertes Bild (wenn response_formatb64_jsonist)
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
{
"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 API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Header
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