Перейти к основному содержанию

​
1. Что указывать в качестве базового URL API?

В зависимости от протокола в основном используются следующие варианты: Внимание: если возникает ошибка 404, проверьте, не добавлен ли лишний /v1 в конце URL. Разные инструменты по-разному обрабатывают склейку путей.

​
2. Что делать, если при вызове возвращается 401 “недействительный токен”?

  1. Убедитесь, что API Key создан корректно: https://jiekou.vip/settings/key-management
  2. Убедитесь, что формат Authorization в заголовке запроса: Bearer sk_xxxxxx
  3. Если используется Claude Code, переменную окружения следует задать как ANTHROPIC_AUTH_TOKEN=sk_xxxxx（префикс Bearer добавлять не нужно, инструмент добавит его автоматически）

​
3. Как диагностировать 404 “page not found” при вызове?

Распространённые причины:
  • Ошибка в URL: например, используется /v3/glm-asr, но путь написан с опечаткой
  • Ошибка маршрутизации модели: например, для моделей Codex нужно использовать /v1/responses, а не /v1/chat/completions
  • Проблема автоматической склейки пути инструментом: некоторые инструменты（например, cc-switch）автоматически добавляют /chat/completions, поэтому Base URL не должен содержать этот путь

​
4. Как настроить Jiekou.AI в Claude Code?

Настройка переменных окружения: Windows cmd： 
set ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=sk_您的API密钥
set ANTHROPIC_MODEL=claude-opus-4-1-20250805
set ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
Mac/Linux bash： 
export ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=sk_您的API密钥
export ANTHROPIC_MODEL=claude-opus-4-1-20250805
export ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
Справочная документация: https://docs.jiekou.ai/docs/integration/claudecode

​
5. Как решить проблему, если Claude Code требует обязательный вход/проверку?

В новейшей версии Claude Code может принудительно требоваться вход в аккаунт. Решения:
  • Использовать плагин Cline вместо него（найдите его в магазине расширений VSCode）
  • Либо использовать совместно с инструментами переадресации, такими как cc-switch

​
6. Как вызывать модели GPT-5.1 / Codex? Почему возвращается ошибка 400?

Для серии GPT-5.1（включая Codex）нужно использовать OpenAI Responses API, а не Chat Completions: 
curl "https://api.highwayapi.ai/openai/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <API Key>" \
-d '{
    "model": "gpt-5.1-codex",
    "input": [...],
    "max_output_tokens": 64000
  }'

​
7. Что делать, если Claude 4.5 возвращает ошибку, связанную с “thinking block”?

Обычно в ошибке указано: Expected ‘thinking’ or ‘redacted_thinking’, but found ‘text’。Это связано с тем, что после включения функции Thinking в Claude 4.5 контекст должен содержать определённый формат блоков размышлений. Рекомендуется:
  • Очистить историю диалога и начать заново
  • Либо отключить функцию Thinking（если она не нужна）
  • Использовать нативный протокол Anthropic вместо протокола, совместимого с OpenAI（в последнем поддержка Thinking может быть неполной）

​
8. Claude API возвращает ошибку “входные данные слишком длинные”?

У моделей Claude есть ограничения на длину входных данных（обычно max_tokens поддерживает максимум 64000）. Проверьте:
  • Длину входного текста
  • Размер изображений Base64（слишком большие изображения рекомендуется предварительно сжать）
  • Накопленную длину контекста истории диалога
Связаться с поддержкой Если приведённый выше FAQ не помог решить вашу проблему, свяжитесь с технической поддержкой следующими способами:
  • Группа технической поддержки в Enterprise WeChat/WeChat（рекомендуется, самый быстрый ответ）
  • Формат предоставляемой информации:
    • Описание проблемы + скриншоты
    • ID аккаунта (UUID)
    • Trace ID（если есть, обычно указан в сообщении об ошибке）
    • Параметры запроса（после удаления чувствительных данных）