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

Краткий ответ

Помните: моделям OpenAI нужны /v1, Claude использует только корневой домен, Gemini нужны /v1beta. Неверный Base URL — самая распространенная проблема интеграции.

Почему для разных моделей используются разные базовые URL?

Это определяется реализацией SDK у каждого вендора:
  • OpenAI SDK: добавляет пути ресурсов после base_url, поэтому /v1 должен быть указан
  • Anthropic SDK: внутренне добавляет /v1/messages — если вы добавите /v1 самостоятельно, получится /v1/v1/messages (ошибка 404)
  • Google GenAI SDK: использует путь /v1beta, SDK автоматически обрабатывает объединение путей

Примеры кода

Совместимые модели OpenAI (GPT / DeepSeek / Llama и т. д.)

Модели Claude (Anthropic SDK)

Модели Gemini (Google GenAI SDK)

Распространенная ошибка для пользователей Claude: при использовании официального Anthropic SDK базовый URL должен быть только https://api.apiyi.com — не добавляйте /v1. Однако если вы вызываете Claude через совместимый режим OpenAI SDK, вам действительно нужен /v1.

Выбор доменного узла

APIYI предоставляет 3 доменных узла с одинаковыми возможностями, различающихся сетевой маршрутизацией и архитектурой развертывания:

🌏 По умолчанию (рекомендуется)

api.apiyi.comОсновная линия по умолчанию. Рекомендуется для всех клиентов как внутри материкового Китая, так и за его пределами.

🏢 Резервный для Китая / Business

b.apiyi.comРезервный узел и корпоративная линия Business. Используйте, если основной узел недоступен.

⚡ Глобальное ускорение Cloudflare CDN

api-cf.apiyi.comГлобальное CDN-ускорение Cloudflare. Для API-вызовов только с текстом. Ограничение по таймауту — 100 секунд.
Ограничение узла Cloudflare CDN: api-cf.apiyi.com развернут на Cloudflare Workers с максимальным таймаутом запроса 100 секунд. Поэтому:
  • ✅ Подходит для: обычного текстового чата, генерации короткого текста и других запросов с быстрым ответом
  • ❌ Не подходит для: сложных задач с длинным текстом длительностью более 100 секунд
  • ❌ Не подходит для: Nano Banana Pro и других задач генерации изображений
  • ❌ Не подходит для: API-вызовов генерации видео
Если выполнение ваших задач может занимать более 100 секунд, используйте вместо него api.apiyi.com (или резервный узел b.apiyi.com).
Мы рекомендуем настроить резервный узел в вашем коде для автоматического переключения, чтобы повысить доступность сервиса.

Устранение распространенных ошибок

Полный справочник по конфигурации

OpenAI-совместимые модели

Модели Claude (Anthropic SDK)

Модели Gemini

При использовании Google GenAI SDK для Gemini установите base_url на корневой домен и api_version: "v1beta" — SDK автоматически сформирует полный путь.