Перейти к содержанию
Справочник APIQwen: ошибки и границы

Qwen: ошибки и границы

Публичные коды Qwen, очередь, безопасные повторы и неподдержанные входы.

Сначала читайте HTTP-статус и error.code. Messages оборачивает ошибку в Anthropic-совместимый объект type: "error"; Chat Completions и Responses используют OpenAI-совместимый объект error. Код и действие ниже одинаковы для всех форматов.

Исправьте запрос

HTTP / codeПричинаДействие
400 invalid_jsonТело не является JSON-объектом.Исправьте JSON и content-type: application/json.
400 unsupported_parameterЗначение поля меняет ответ, а Qwen такую настройку не поддерживает: например непустой stop, n больше 1 или logprobs.Уберите поле из error.param. Параметры выборки вроде temperature и top_p принимаются и не влияют на ответ.
400 invalid_stream / invalid_stream_optionsstream не boolean или в stream_options есть поле, кроме include_usage.Передайте boolean и только include_usage.
400 messages_required / invalid_input / max_tokens_requiredНет messages (в Responses нет input); в Messages нет max_tokens.Передайте непустую историю и, в Messages, бюджет вывода.
400 invalid_token_limit / conflicting_token_limitsПредел ответа меньше 1 или больше 131 072 либо переданы оба поля max_tokens и max_completion_tokens.Оставьте одно поле. Значение выше предела модели (65 536 у Plus-моделей и qwen3.5-omni-plus, 131 072 у остальных) шлюз сам уменьшает до этого предела.
400 invalid_tools / unsupported_tool_type / invalid_tool_schematools не массив объектов, тип не function или схема параметров некорректна.Исправьте объявление функции в форме выбранного API.
400 unverified_server_toolВ Messages запрошен серверный инструмент, кроме web_search_* и web_fetch_*.Используйте клиентскую функцию; поиск Qwen выбирает сам.
400 stored_responses_unsupportedВ Responses передан store: true или previous_response_id: Qwen не хранит ответы.Уберите эти поля и передавайте всю историю в input.
400 background_unsupportedВ Responses передан background: true.Уберите background: ответ приходит обычным ответом или потоком.
400 invalid_tool_choicetool_choice требует функцию, которой нет в tools.Передайте auto, none, required или имя объявленной функции.
400 unsupported_image / invalid_image / inline_media_requiredКартинка для qwen3.7-max, файл не PNG, JPEG или WEBP либо передана ссылка вместо base64 (ссылка или file_id в Messages и file_id в Chat получают 400 unsupported_parameter).Выберите модель с картинками и передайте файл в теле запроса.
400 unsupported_media / invalid_attachment / invalid_document / document_encoding_unsupportedДокумент не PDF, TXT, CSV, Markdown или JSON, данные не в base64, PDF повреждён, в нём больше 200 страниц или слишком много текста, либо текстовый файл не в UTF-8.Передайте поддерживаемый файл в теле запроса; большой PDF разделите на части.
400 effort_unsupportedВ Messages передан output_config.effort.Уберите output_config: уровень усилия Qwen не принимает.
404 model_not_foundID не совпадает с одним из семи ID Qwen или на /qwen/v1 передана модель другого семейства.Получите каталог через GET /qwen/v1/models и передайте точный ID.
413 context_too_largeВход больше контекста модели или текст запроса больше 2 МиБ.Сократите историю или уменьшите бюджет вывода.
413 attachments_too_large / too_many_imagesВложения запроса вместе слишком большие или в истории больше 32 картинок.Уменьшите вложения, уберите старые из истории или начните новый разговор.
413 request_body_too_largeТело запроса больше 12 МиБ: base64 увеличивает файлы примерно на треть, поэтому файл больше 9 МиБ получает этот отказ.Уменьшите вложения или отправьте их в разных запросах.

Ключ, баланс и лимиты

HTTP / codeДействие
401 missing_api_keyКлюч не передан: добавьте заголовок Authorization: Bearer gd-… или x-api-key.
401 invalid_api_keyПроверьте полный активный gd-… и заголовок Authorization: Bearer ….
402 insufficient_creditПроверьте остаток общего баланса ключа.
402 request_reserve_exceeds_creditУменьшите бюджет вывода или пополните баланс; финальное списание всё равно идёт по оценке фактического ответа.
403 api_key_pausedQwen или весь ключ стоит на паузе в личном кабинете. Снимите паузу.
403 model_not_allowedМодель не разрешена в настройках ключа. Разрешите её в личном кабинете.
429 customer_hour_limit / customer_day_limitДостигнут лимит расходов из личного кабинета. Измените лимит или дождитесь окончания окна.
429 client_key_rate_limitПодождите не меньше значения Retry-After и повторите один раз.

Очередь и временная недоступность

HTTP / codeЧто означаетПовтор
429 queue_timeoutСвободный аккаунт Qwen не появился за 30 секунд.Retry-After: 30. Добавьте jitter и не запускайте параллельные скрытые повторы.
429 provider_at_capacityЗаняты все модели Qwen, которые принимают этот запрос.Retry-After: 5. Повторяйте с backoff.
503 qwen_unavailableQwen временно недоступен.Retry-After: 30. Повторите позже.
503 model_unavailableВыбранная модель Qwen сейчас недоступна.Retry-After: 30. Выберите другую модель Qwen или повторите позже.
502 generation_timeoutГенерация заняла больше 10 минут.Сократите задачу или бюджет вывода и отправьте новый запрос.
502 с другим кодомQwen не завершил ответ или не смог продолжить разговор.Повторите запрос; при постоянной ошибке передайте код в поддержку.

Диагностика без секретов

  • Сохраните UTC-время, адрес, model, HTTP-статус и error.code.
  • Добавьте request_id из ответа или ID из личного кабинета.
  • Не отправляйте ключ, полный prompt, ответ модели или содержимое картинки.
  • Проверьте страницу состояния и затем обратитесь в @Guard_help.

Разделы документации

На этой странице