FAQ

Следуйте Быстрому старту: войдите в учётную запись, создайте API Key, выберите модель и отправьте минимальный запрос. Начните с OpenAI Chat-совместимого вызова, а после проверки основного пути добавляйте Streaming, инструменты или мультимодальный ввод.

Создавайте, отключайте или удаляйте токены в API Keys. Для разных сред рекомендуется использовать разные Key. Неиспользуемые или предположительно скомпрометированные Key своевременно отключайте или удаляйте.

Рекомендуемый Base URL — https://api.agtcloud.cn/v1. Для OpenAI SDK задайте его в base_url или baseURL. OpenAI-совместимые интерфейсы обычно используют Authorization: Bearer your-api-key. Для других протоколов используйте Header соответствующего API Reference. Подробнее см. API Key, Base URL и аутентификация.

Не рекомендуется. Долгосрочный API Key храните на доверенном сервере, в серверных переменных среды или сервисе управления секретами. Браузер и мобильное приложение должны обращаться к вашему серверу, который вызывает AGTCloud, чтобы пользователь не мог извлечь и злоупотребить Key.

Обычно Base URL уже содержит /v1, а код добавляет /v1 ещё раз перед Endpoint. Используйте https://api.agtcloud.cn/v1 как Base URL SDK и позвольте SDK добавлять /chat/completions и другие Endpoint. При диагностике проверьте полный отправленный URL.

Текущие модели и их ID показаны в каталоге моделей. Видимость меняется с настройками платформы и правами учётной записи. Копируйте ID с текущей страницы и ориентируйтесь на фактический результат запроса.

Если не нужно сохранять семантику исходного протокола, начните с OpenAI Chat Completions: его SDK и способы подключения распространены. Для существующего приложения Anthropic, Gemini или Responses сначала сохраните SDK и структуру сообщений, затем проверьте адаптацию целевой модели.

При 401 проверьте Header протокола и API Key; при 403 — права учётной записи, Key и модели; при 404 — Base URL, Endpoint, ID модели или задачи. Не повторяйте эти ошибки бесконечно: сначала устраните явную причину. Подробнее см. Ошибки и диагностика.

Проверьте x-request-id, request-id или x-oneapi-request-id в заголовках и сохраните имеющийся идентификатор. Request ID также может быть в теле ошибки. Если его нет, сохраните время, Method, Path, модель и HTTP-статус. Примеры см. в Request ID.

Сразу отключите или удалите старый Key в API Keys, создайте новый и обновите использующие его сервисы. Проверьте копии в репозиториях, журналах, снимках экрана и чатах. Если Key попадал в Git, удаления текущего файла недостаточно: обработайте историю по правилам безопасности команды.

Подготовьте время и часовой пояс, Method, Path, ID модели, HTTP-статус, обезличенную ошибку, версии SDK и среды выполнения и минимальные шаги воспроизведения. Если есть Request ID, сохраните его. Не передавайте полный API Key, Header, Cookie, клиентские Prompt и частные файлы.