Przejdź do treści

Dokumentacja programisty UlazAI

Obraz API

POST /api/v1/generate/

Punkt końcowy generowania obrazu kanonicznego

Użyj tego punktu końcowego dla wszystkich nowych integracji. Wybierz model z model i opcjonalnie przejść image_urls do edycji procesów roboczych w obsługiwanych modelach.

Stan ankiety z /api/v1/generate/{generation_id}/ i używać /api/v1/generate/history/ dla historii pracy.

Poproś o umowę

Pole Typ Wymagane Notatki
prompt ciąg Tak Od 1 do 5000 znaków
model ciąg Nie Domyślnie gpt_image_15
size ciąg Nie Dozwolone wartości zależą od wybranego modelu. gpt_image_2 akceptuje również niestandardowe współczynniki, takie jak 5:7 lub 1024x768.
quality ciąg Nie Tryb rozdzielczości lub jakości, zależny od modelu
image_urls tablica[ciąg] Nie* Używany do edycji procesów roboczych w modelach takich jak gpt_image_2, qwen_image, i wan_2_7_image. Wymagane dla ideogram_character.

Selektor modelu

Przełączaj ustawienia wstępne modelu, aby natychmiast aktualizować przykłady żądań.

Seedream 5.0 Lite model=seedream_5_lite

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

Dozwolone rozmiary: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9

Dopuszczalne wartości jakości: basic, high

Tryb edycji: obsługiwane

Fragmenty żądań na żywo

Poniższe fragmenty odpowiadają wybranemu wstępnemu modelowi.

ZWIŃ

JavaScript (pobierz)

Python (żądania)

Przykłady odpowiedzi

201 Utworzono

{
  "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 Wymagana płatność

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

400 Złych żądań

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