Краткий ответ
Помните: моделям 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)
Выбор доменного узла
APIYI предоставляет 4 доменных узла с одинаковыми возможностями, отличающиеся сетевой маршрутизацией и архитектурой развертывания:🌏 Глобальный прямой доступ (рекомендуется для зарубежных пользователей)
vip.apiyi.comПрямое подключение к backend, минимальная задержка. Рекомендуется для всех клиентов за пределами материкового Китая.🇨🇳 Китай по умолчанию (рекомендуется для материкового Китая)
api.apiyi.comОптимизирован для сети материкового Китая. По умолчанию для клиентов из материкового Китая.🏢 Резервный узел Китая / бизнес
b.apiyi.comРезервный узел и бизнес-линия для enterprise. Используйте, когда основной узел недоступен.⚡ Глобальное ускорение через Cloudflare CDN
api-cf.apiyi.comГлобальное ускорение через Cloudflare CDN. Для вызовов API только для текста. Имеет ограничение тайм-аута 100 секунд.Устранение распространённых ошибок
Полная справка по конфигурации
OpenAI-Compatible Models
Claude Models (Anthropic SDK)
Gemini Models
При использовании Google GenAI SDK для Gemini установите
base_url в корневой домен, а api_version: "v1beta" — SDK автоматически сформирует полный путь.