Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

Übersicht

Erstellt eine Variation eines gegebenen Bildes. Erfordert multipart/form-data Content-Type.

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.
image
file
erforderlich
Das Bild als Basis für die Variation. Muss eine gültige PNG-Datei sein, kleiner als 50MB und quadratisch.
model
string
Standard:"dall-e-2"
Das Modell für Bildvariationen. Derzeit wird nur dall-e-2 unterstützt.
n
integer
Standard:"1"
Die Anzahl der zu generierenden Bilder. Muss zwischen 1 und 10 liegen.
size
string
Die Größe der generierten Bilder. Muss 256x256, 512x512 oder 1024x1024 sein.
response_format
string
Standard:"url"
Das Format der zurückgegebenen Bilder. Muss url oder b64_json sein.
user
string
Eine eindeutige Kennung für Ihren Endbenutzer zur Missbrauchsüberwachung.

Antwort

created
integer
Unix-Zeitstempel der Bilderstellung.
data
array
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)
curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Hinweise

Bildvariationen sind nur mit DALL-E 2 verfügbar. Das Modell generiert neue Bilder, die dem Originalbild in Stil und Inhalt ähnlich sind.