Générer une image
Mettez une image en file d'attente à partir d'une consigne texte et interrogez le résultat. Renvoie un identifiant de tâche immédiatement plutôt que de maintenir la connexion ouverte.
Une image prend environ 10 à 40 secondes, trop long pour maintenir une requête HTTP ouverte. La génération se fait donc en deux appels : lancer une tâche, puis l'interroger.
POST /api/v1/ai/images
POST /api/v1/ai/images
{
"prompt": "un vélo rouge appuyé contre un mur jaune, lumière douce du matin",
"aspectRatio": "16:9",
"model": "premium"
}| Champ | Requis | Description |
|---|---|---|
| prompt | Oui | Ce qu'il faut dessiner. Jusqu'à 2000 caractères |
| aspectRatio | Non | 1:1 (par défaut), 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21 |
| model | Non | standard (par défaut) ou premium |
| quality | Non | LOW, MEDIUM ou HIGH |
| sessionId | Non | Regroupe les images liées. Sans lui, une session est créée pour vous |
| referenceImages | Non | Jusqu'à 5 URL d'images publiques pour orienter le résultat |
{
"jobId": "generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846",
"sessionId": "b31c7a44-2f19-4c85-9d60-7e2af4c81b93",
"status": "queued"
}Conservez le sessionId et transmettez-le à l'appel suivant pour garder un ensemble d'images groupées, comme une conversation garde ses messages. Sans lui, chaque image ouvre sa propre session.
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
}| Statut | Signification |
|---|---|
queued | En attente d'un worker |
generating | Le modèle dessine |
processing | Envoi du résultat |
completed | imageUrl est prête |
failed | error en donne la raison |
Interrogez toutes les 3 à 5 secondes. Plus vite ne fait que consommer votre limite de débit.
Si vous préférez ne pas interroger du tout, enregistrez un webhook : nous enverrons image.completed avec les mêmes champs dès que la tâche se termine, ou image.failed avec la raison.
imageUrl pointe vers le CDN et peut aller directement dans les mediaUrls d'une publication. Générer et planifier revient donc à : créer l'image, interroger jusqu'à completed, puis créer une publication avec cette URL.
Crédits
Les crédits sont débités au démarrage de la génération et remboursés automatiquement en cas d'échec : une tâche échouée ne coûte rien. Avec votre propre clé OpenAI ou Google connectée, les images passent par votre clé et ne consomment aucun crédit. premium et standard ne coûtent pas le même nombre de crédits.