Ошибки и ограничения

Типовые ответы с ошибками

Сбои аутентификации и ограничения частоты могут возвращаться на раннем этапе шлюзом или middleware:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authorization Bearer token is required"
  },
  "request_id": "..."
}

Пример ограничения частоты:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded, please try again later"
  },
  "request_id": "..."
}

Идентификатор модели не найден:

{
  "detail": "App not found: not_exists"
}

Модель не авторизована:

{
  "detail": "Model not allowed for this user"
}

Webhook не поддерживается:

{
  "detail": "webhook not supported"
}

Ошибка выполнения:

{
  "detail": "Runtime execution failed"
}

Неподдерживаемые возможности

Webhook

Webhook сейчас не поддерживается. Запросы с webhook-колбэками в теле, query-параметрах или заголовках отклоняются:

curl -X POST "${BASE_URL}/v1/queue/${ENDPOINT}" \
  "${COMMON_HEADERS[@]}" \
  -d '{
    "prompt": "a cinematic photo of a cat astronaut",
    "webhook_url": "https://example.com/hook"
  }'

{
  "detail": "webhook not supported"
}

SSE stream

curl "${BASE_URL}/v1/queue/${ENDPOINT}/requests/${REQUEST_ID}/status/stream" ...

{
  "detail": "SSE streaming not supported"
}

Sync

Текущая мультимодальная очередь предоставляет только асинхронный протокол задач. Синхронного endpoint генерации нет.

curl -X POST "${BASE_URL}/v1/queue/${ENDPOINT}/sync" ...

{
  "detail": "Not Found"
}