UlazAI API Dokumentation

Bild generieren

POST /api/v1/generate/

Erstellen Sie eine neue Aufgabe zur Bildgenerierung. Credits werden sofort abgezogen, wenn die Generierung beginnt.

Authentifizierung erforderlich: Dieser Endpunkt erfordert eine Authentifizierung per Token oder API-Schlüssel.

Anfrage

Überschriften

Content-Type application/json
Authorization Token <Ihr_Token>

Körper erforderlich

prompt erforderlich
Zeichenfolge

Beschreibung des Bildes, das Sie generieren möchten. Maximal 1000 Zeichen.

Beispiel: "Ein wunderschöner Sonnenuntergang über den Bergen"
Größe optional
Zeichenfolge

Bildgröße. Der Standardwert ist 1:1.

Mögliche Werte: [1:1, 3:2, 2:3]
Beispiel: "1:1"
Qualität optional
Zeichenfolge

Alle Bilder werden standardmäßig in höchster Qualität generiert.

Notiz: Der Qualitätsparameter wird ignoriert – alle Bilder sind von hoher Qualität
Beispiel: "hd" (oder ganz weglassen)
Stil optional
Zeichenfolge

Bildstil. Standard ist natürlich.

Mögliche Werte: [natürlich, lebendig]
Beispiel: "natürlich"

Beispielanfrage

{
  "prompt": "A beautiful sunset over the mountains",
  "size": "1:1",
  "style": "natural"
}

Antworten

201 Anfrage erfolgreich

Die Generierung wurde erfolgreich gestartet

{
  "success": true,
  "data": {
    "generation_id": "uuid-here",
    "status": "processing",
    "estimated_time": "15-30 seconds",
    "credits_used": 24,
    "credits_remaining": 76,
    "message": "Generation started successfully"
  }
}
402 Zahlung erforderlich

Nicht genügend Credits, um die Anfrage abzuschließen

{
  "success": false,
  "error": "Insufficient credits. Need 24, have 10",
  "credits_needed": 24,
  "credits_balance": 10
}
400 Ungültige Anforderung

Ungültige Anforderungsparameter

{
  "success": false,
  "error": "Prompt is required",
  "details": {
    "prompt": "This field is required"
  }
}

Kreditkosten

Die Kreditkosten richten sich nach der Bildgröße (alle Bilder sind von hoher Qualität):

Größe Credits
1:1 24
3:2 24
2:3 24

Wichtige Hinweise

  • • Credits werden sofort abgezogen, wenn die Generierung beginnt
  • • Credits werden zurückerstattet, wenn die Generierung fehlschlägt
  • • Erzeugte Bilder werden 30 Tage lang gespeichert
  • • Die maximale Eingabeaufforderungslänge beträgt 1000 Zeichen
  • • Verwenden Sie die Generations-ID, um den Status zu überprüfen und Ergebnisse abzurufen