Базовые URL
Настройка, на которой спотыкаются все: какой URL ожидает каждый клиент — с суффиксом /v1 или без него.
Почти каждый сбой интеграции связан с ошибкой в базовом URL. На этой странице точно указано, какое значение нужно задать.
Правило
| Клиент | Укажите базовый URL | Тогда он вызывает |
|---|---|---|
| Anthropic SDK (Python / TS) | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| Claude Code | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| OpenAI SDK (Python / TS) | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
| LangChain / LiteLLM / Cursor | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
Клиенты Anthropic: без
/v1. Клиенты OpenAI: с /v1. Anthropic SDK добавляет /v1/messages к любому указанному базовому URL; OpenAI SDK добавляет только /chat/completions. Добавление /v1 к базовому URL Anthropic приводит к запросам на /v1/v1/messages, что возвращает ошибку 404.Как определить, какую ошибку вы допустили
| Вы видите | Значение |
|---|---|
404 и путь содержит /v1/v1/ | Вы добавили /v1 к базовому URL в формате Anthropic. Удалите его. |
404 для /chat/completions без /v1 | Вы пропустили /v1 в базовом URL в формате OpenAI. Добавьте его. |
404 для /v1/chat/completions из инструмента Anthropic | Инструмент использует Messages, а не Chat Completions. Используйте базовый URL и эндпоинт Anthropic. |
| Подключение работает, но каждый вызов возвращает ошибку 401 | URL верный, но заголовок аутентификации не соответствует этому формату. См. Аутентификация. |
Проверка без SDK
Это самый быстрый способ убедиться, что URL и ключ верны, прежде чем искать причину во фреймворке:
"c"># should return JSON with a "data" array of model ids
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"A 200 означает, что URL и ключ верны, а оставшаяся проблема связана с настройкой клиента.