Zum Inhalt springen

UlazAI Entwicklerdokumentation

Bild API

POST /api/v1/generate/

Endpunkt für die kanonische Bildgenerierung

Verwenden Sie diesen Endpunkt für alle neuen Integrationen. Wählen Sie ein Modell mit model und optional bestehen image_urls für Bearbeitungsworkflows auf unterstützten Modellen.

Umfragestatus mit /api/v1/generate/{generation_id}/ und verwenden /api/v1/generate/history/ für den beruflichen Werdegang.

Vertrag anfordern

Feld Typ Erforderlich Notizen
prompt Zeichenfolge Ja 1 bis 5000 Zeichen
model Zeichenfolge Nein Standardmäßig ist gpt_image_15
size Zeichenfolge Nein Zulässige Werte hängen vom ausgewählten Modell ab. gpt_image_2 akzeptiert auch benutzerdefinierte Verhältnisse wie 5:7 oder 1024x768.
quality Zeichenfolge Nein Auflösungs- oder Qualitätsmodus, modellspezifisch
image_urls Array[Zeichenfolge] Nein* Wird für Bearbeitungsworkflows an Modellen wie verwendet gpt_image_2, qwen_image, und wan_2_7_image. Erforderlich für ideogram_character.

Modellauswahl

Wechseln Sie zwischen Modellvoreinstellungen, um Anforderungsbeispiele sofort zu aktualisieren.

Seedream 5.0 Lite model=seedream_5_lite

Multimodal reasoning model with text-to-image and image editing.

Zulässige Größen: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9

Zulässige Qualitätswerte: basic, high

Bearbeitungsmodus: unterstützt

Live-Anfrage-Snippets

Die folgenden Ausschnitte folgen der ausgewählten Modellvoreinstellung.

cURL

JavaScript (Abruf)

Python (Anfragen)

Antwortbeispiele

201 erstellt

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "processing",
    "estimated_time": "varies by model and queue",
    "credits_used": 8,
    "credits_remaining": 124,
    "message": "Generation started successfully"
  }
}

402 Zahlung erforderlich

{
  "success": false,
  "error": "Insufficient credits. Need 18, have 7",
  "credits_needed": 18,
  "credits_balance": 7
}

400 Ungültige Anfrage

{
  "success": false,
  "error": "Invalid size. Must be one of: 1:1, 3:2, 2:3"
}