Документация APIЗадачи и ограниченное ожидание
Опрос асинхронной работы и чтение очищенных результатов
Операции с изображениями оформляются как надёжные задачи. Первый ответ содержит
полный публичный объект задачи и Location: /api/v1/jobs/{job_id}.
Чтение задачи
curl https://sci-draw.com/api/v1/jobs/job_012345 \
-H 'Authorization: Bearer sd_YOUR_KEY'Требуемое право: jobs:read. Задачи читаются одновременно по идентификатору и по
принадлежности аккаунту. Несуществующая задача и задача другого аккаунта дают
одинаковый ответ 404 JOB_NOT_FOUND.
Жизненный цикл статусов
| Статус | Значение |
|---|---|
queued | принята и ожидает выполнения |
processing | выполняется |
succeeded | доступен result.files |
failed | в error — стабильный публичный код и сообщение |
canceled | задача выполняться не будет |
Финальные статусы больше никогда не меняются. Незавершённые задачи опрашивайте с
интервалом из заголовка Retry-After, который возвращают запросы на создание;
сейчас рекомендуется две секунды.
Ограниченное ожидание
Эндпоинты создания принимают Prefer: wait=N, где N — целое число от 1 до 30.
Если задача завершится за это время, эндпоинт вернёт 200. Если к моменту
истечения срока она ещё выполняется, вернётся текущая задача со статусом 202.
Это удобно для интерактивных клиентов, но серверные интеграции должны всегда
сохранять идентификатор задачи и быть готовы к опросу.
Успешный результат
{
"success": true,
"data": {
"id": "job_012345",
"object": "image_job",
"type": "image_generation",
"status": "succeeded",
"created_at": "2026-08-07T12:00:00.000Z",
"completed_at": "2026-08-07T12:00:41.000Z",
"credits_reserved":
Ни один ответ по задаче не содержит отправленных промптов, ссылок на исходные изображения, внутренних идентификаторов, деталей выполнения и закрытой диагностики.