Задачи и ограниченное ожидание

Операции с изображениями оформляются как надёжные задачи. Первый ответ содержит полный публичный объект задачи и 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.

Жизненный цикл статусов

Финальные статусы больше никогда не меняются. Незавершённые задачи опрашивайте с интервалом из заголовка 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": 5,
    "credits_consumed": 5,
    "result": {
      "files": [{
        "id": "file_012345",
        "url": "https://sci-draw.com/generated/example.png",
        "format": "png",
        "mime_type": "image/png",
        "width": 2048,
        "height": 1152
      }]
    },
    "error": null
  }
}

Ни один ответ по задаче не содержит отправленных промптов, ссылок на исходные изображения, внутренних идентификаторов, деталей выполнения и закрытой диагностики.