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"
}| Pole | Wymagane | Opis |
|---|---|---|
| prompt | Tak | Co ma powstać. Do 2000 znaków |
| aspectRatio | Nie | 1:1 (domyślnie), 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21 |
| model | Nie | standard (domyślnie) lub premium |
| quality | Nie | LOW, MEDIUM lub HIGH. Używane tylko z własnym kluczem OpenAI; przy kredytach AdaptlyPost jakość wyznacza model |
| sessionId | Nie | Grupuje powiązane obrazy. Jeśli go pominiesz, sesja zostanie utworzona automatycznie |
| referenceImages | Nie | Do 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
}| Status | Znaczenie |
|---|---|
queued | Czeka na proces roboczy |
generating | Model tworzy obraz |
processing | Trwa przesyłanie wyniku |
completed | imageUrl jest gotowy |
failed | error 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.