REST APIPOST

Generuj obraz

Dodaj do kolejki generowanie obrazu na podstawie opisu tekstowego i odpytuj o wynik. Od razu zwraca identyfikator zadania, zamiast utrzymywać otwarte połączenie.

Uprawnienie: ai.generate. Zobacz Role i uprawnienia.

Wygenerowanie obrazu trwa około 10 do 40 sekund, czyli zbyt długo, by trzymać otwarte żądanie HTTP. Dlatego generowanie to dwa wywołania: uruchomienie zadania, a potem odpytywanie o jego stan.

POST /api/v1/ai/images

POST /api/v1/ai/images
{
  "prompt": "a red bicycle leaning against a yellow wall, soft morning light",
  "aspectRatio": "16:9",
  "model": "premium"
}
PoleWymaganeOpis
promptTakCo ma powstać. Do 2000 znaków
aspectRatioNie1:1 (domyślnie), 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21
modelNiestandard (domyślnie) lub premium
qualityNieLOW, MEDIUM lub HIGH. Używane tylko z własnym kluczem OpenAI; przy kredytach AdaptlyPost jakość wyznacza model
sessionIdNieGrupuje powiązane obrazy. Jeśli go pominiesz, sesja zostanie utworzona automatycznie
referenceImagesNieDo 5 publicznych adresów URL obrazów, które ukierunkują wynik
{
  "jobId": "generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846",
  "sessionId": "b31c7a44-2f19-4c85-9d60-7e2af4c81b93",
  "status": "queued"
}

Zachowaj sessionId i przekaż go w kolejnym wywołaniu, aby trzymać zestaw obrazów razem, tak jak rozmowa trzyma swoje wiadomości. Jeśli go pominiesz, każdy obraz rozpocznie własną sesję.

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
}
StatusZnaczenie
queuedCzeka na proces roboczy
generatingModel tworzy obraz
processingTrwa przesyłanie wyniku
completedimageUrl jest gotowy
failederror podaje przyczynę

Odpytuj co 3 do 5 sekund. Częstsze zapytania tylko zużywają limit.

Jeśli wolisz w ogóle nie odpytywać, zarejestruj webhook, a gdy zadanie się zakończy, wyślemy POST image.completed z tymi samymi polami albo image.failed z przyczyną.

imageUrl wskazuje na CDN i może trafić prosto do mediaUrls posta, więc generowanie i planowanie wygląda tak: utwórz obraz, odpytuj aż do completed, a potem utwórz post z tym adresem URL.

Kredyty

Kredyty są pobierane w chwili rozpoczęcia generowania i automatycznie zwracane w razie niepowodzenia, więc nieudane zadanie nic nie kosztuje. Z podłączonym własnym kluczem OpenAI lub Google obrazy powstają na twoim kluczu i w ogóle nie zużywają kredytów. premium i standard kosztują różną liczbę kredytów.