Skip to main content

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

Помните: моделям 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 предоставляет 4 доменных узла с одинаковыми возможностями, отличающиеся сетевой маршрутизацией и архитектурой развертывания:

🌏 Глобальный прямой доступ (рекомендуется для зарубежных пользователей)

vip.apiyi.comПрямое подключение к backend, минимальная задержка. Рекомендуется для всех клиентов за пределами материкового Китая.

🇨🇳 Китай по умолчанию (рекомендуется для материкового Китая)

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

🏢 Резервный узел Китая / бизнес

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

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

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

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

Полная справка по конфигурации

OpenAI-Compatible Models

Claude Models (Anthropic SDK)

Gemini Models

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