> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройка API и техническая интеграция

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

В зависимости от протокола в основном используются следующие варианты:

* Формат, совместимый с OpenAI: [https://api.highwayapi.ai/openai](https://api.highwayapi.ai/openai) или [https://api.highwayapi.ai/openai/v1/chat/completions](https://api.highwayapi.ai/openai/v1/chat/completions)
* Нативный протокол Anthropic: [https://api.highwayapi.ai/anthropic](https://api.highwayapi.ai/anthropic) （для таких инструментов, как Claude Code）
* Специально для генерации изображений/видео: [https://api.highwayapi.ai/v3/](https://api.highwayapi.ai/v3/) （например, Gemini, Nano Banana и т. д.）

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

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

1. Убедитесь, что API Key создан корректно: [https://jiekou.vip/settings/key-management](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](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（если есть, обычно указан в сообщении об ошибке）
  * Параметры запроса（после удаления чувствительных данных）