Bild generieren
Stellen Sie ein Bild aus einem Text-Prompt in die Warteschlange und fragen Sie das Ergebnis ab. Gibt sofort eine Job-ID zurück, statt die Verbindung offen zu halten.
Ein Bild braucht etwa 10 bis 40 Sekunden, zu lang für eine offene HTTP-Anfrage. Die Generierung läuft deshalb über zwei Aufrufe: Job starten, dann abfragen.
POST /api/v1/ai/images
POST /api/v1/ai/images
{
"prompt": "ein rotes Fahrrad an einer gelben Wand, weiches Morgenlicht",
"aspectRatio": "16:9",
"model": "premium"
}| Feld | Pflicht | Beschreibung |
|---|---|---|
| prompt | Ja | Was gezeichnet werden soll. Bis zu 2000 Zeichen |
| aspectRatio | Nein | 1:1 (Standard), 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21 |
| model | Nein | standard (Standard) oder premium |
| quality | Nein | LOW, MEDIUM oder HIGH |
| sessionId | Nein | Gruppiert zusammengehörige Bilder. Ohne Angabe wird eine Session angelegt |
| referenceImages | Nein | Bis zu 5 öffentliche Bild-URLs, die das Ergebnis lenken |
{
"jobId": "generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846",
"sessionId": "b31c7a44-2f19-4c85-9d60-7e2af4c81b93",
"status": "queued"
}Behalten Sie die sessionId und übergeben Sie sie beim nächsten Aufruf, um eine Bildserie zusammenzuhalten, so wie ein Gespräch seine Nachrichten zusammenhält. Ohne sie beginnt jedes Bild eine eigene Session.
GET /api/v1/ai/images/{jobId}
GET /api/v1/ai/images/generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846
{
"jobId": "generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846",
"sessionId": "b31c7a44-2f19-4c85-9d60-7e2af4c81b93",
"status": "completed",
"imageUrl": "https://cdn.adaptlypost.com/ai-images/ai-studio-4c81b93.png",
"imageId": "d7e44a10-93bc-4f27-8ae5-1b06c2f4d938",
"error": null
}| Status | Bedeutung |
|---|---|
queued | Wartet auf einen Worker |
generating | Das Modell zeichnet |
processing | Das Ergebnis wird hochgeladen |
completed | imageUrl ist einsatzbereit |
failed | error nennt den Grund |
Fragen Sie alle 3 bis 5 Sekunden ab. Schneller verbraucht nur Ihr Rate-Limit.
imageUrl zeigt auf das CDN und kann direkt in die mediaUrls eines Beitrags. Generieren und Planen heißt also: Bild erstellen, abfragen bis completed, dann mit dieser URL einen Beitrag anlegen.
Guthaben
Guthaben wird beim Start der Generierung abgebucht und bei einem Fehlschlag automatisch erstattet, ein fehlgeschlagener Job kostet also nichts. Mit verbundenem eigenem OpenAI- oder Google-Schlüssel laufen Bilder über Ihren Schlüssel und verbrauchen gar kein Guthaben. premium und standard kosten unterschiedlich viel.