Статус и результат генерации
/v1/images/jobs/{job_id}Опрос джобы, которую генерация вернула с 202: статус и готовые картинки.
Запрос
job_idstringpathобязательноimg_…)Ответы
completed
{
"id": "img_9f2c1b7e…",
"status": "completed",
"cost_usd": "0.027",
"data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA…" } ]
}Подробности
Нужен ключ в заголовке Authorization: Bearer или x-api-key.
Ручка, которой забирают результат после 202. Джоба видна только тому, кто её создал: чужой существующий id отвечает так же, как несуществующий, — утёкший id не должен подтверждать даже того, что он настоящий.
Форма ответа зависит от статуса и построена вокруг денег. completed — cost_usd (списано) и data с картинками. queued / processing / unknown_submit — estimated_cost_usd, то есть размер ещё живого резерва. failed — cost_usd: "0", потому что провалившаяся генерация не тарифицируется, а резерв уже освобождён.
Срок жизни результата — 7 дней. Дальше байты уезжают из базы в архив, result_url очищается, и тот же GET /v1/images/jobs/{job_id} отвечает { "status": "completed", "archived": true, "data": [] }. Это «срок вышел», а не «генерация ничего не дала» — сохраняй картинки у себя сразу, как получил. Строка джобы и её деньги не удаляются никогда: ретеншен уносит только payload.