Контракт ошибок#
Ошибки используют { error: { message, type, code } }. Никогда не повторяйте бесконечно.
| HTTP | Код | Что делать |
|---|---|---|
| 400 | invalid_request | Исправьте JSON, обязательные поля или лимиты токенов. |
| 401 | invalid_api_key | Проверьте ключ и заголовок Bearer; замените ключ, если он отозван. |
| 402 | insufficient_balance | Проверьте квалификационное подтвержденное пополнение, доступный кредит и бюджет ключа; каждое новое пополнение должно быть не менее 100 USD. |
| 403 | model_not_allowed | Обновите список разрешенных моделей для ключа или выберите разрешенную модель. |
| 404 | model_not_found | Получите /v1/models и используйте точный ID. |
| 409 | pending_reconciliation | Подождите сверки использования перед повторением операции. |
| 413 | request_too_large | Разделите ввод или используйте больший контекст. |
| 422 | unsupported_feature | Выберите развертывание, поддерживающее эту функцию. |
| 429 | quota_exceeded | Уважайте Retry-After, если он предоставлен, и используйте ограниченные повторы; публичная бесплатная пробная квота не предлагается. |
| 502 | upstream_error | Повторите с ограниченной отсрочкой; проверьте статус. |
| 503 | service_unavailable | Проверьте статус сервиса и доступность модели перед повтором. |
Избегайте дублирования работы#
Не считайте, что запрос на инференс был бесплатным, если соединение оборвалось. Проверьте свои записи об использовании. Депозиты независимо идемпотентны по идентификатору транзакции провайдера.
Получение помощи#
Используйте руководство по поддержке, чтобы диагностировать сбойный шаг и подготовить отчёт с кодом ошибки, временем UTC, моделью и синтетическим воспроизведением. Локальный инструмент отчёта не отправляет заявку. Не включайте учётные данные и контент клиента в отчёт.
Пример запроса
curl https://weightsapi.com/v1/chat/completions \
-H "Authorization: Bearer $WEIGHTSAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen/Qwen3-32B",
"messages": [
{
"role": "user",
"content": "Hello!"
}
],
"stream": true
}'