Справочник API
Найдите API AGTCloud по задаче разработки и изучите endpoints, параметры, ответы и онлайн-отладку.
Справочник API AGTCloud содержит адреса запросов, способы аутентификации, Schema параметров, структуры ответов, примеры кода и онлайн-отладку. Сначала найдите API по задаче, затем перейдите на страницу конкретного endpoint для просмотра всех полей.
Первый вызов API
Если у вас ещё нет ключа API или вы не определили Base URL и ID модели, сначала прочитайте Быстрый старт. После базовой настройки вы можете выбрать нужный API ниже.
Основные возможности
Текст, изображения и видео — основные разделы справочника API. Для одной возможности могут быть доступны формат, совместимый с OpenAI, формат поставщика или формат асинхронных задач AGTCloud. Выбирайте по имеющемуся SDK и целевой модели.
Текст и диалог
Генерируйте текст и ведите многоходовые диалоги с помощью Chat Completions, Responses, Anthropic Messages, Gemini Generate Content и других протоколов.
Генерация изображений
Создавайте, редактируйте изображения и их вариации; также доступны Grok Image и асинхронные задачи Midjourney.
Генерация видео
Создавайте и запрашивайте видео через Platform Video Generations, OpenAI Videos, Grok, Kling, Vidu и другие API.
Другие API
Обработка аудио
Синтез речи, транскрипция и перевод аудио, асинхронное распознавание речи и обработка голосов.
Embeddings
Преобразуйте текст или токены в векторы для семантического поиска, кластеризации и оценки сходства.
Rerank
Переупорядочивайте документы-кандидаты по релевантности в формате Jina, Cohere или Xinference.
Realtime
Обрабатывайте текст, аудио и вызовы функций в реальном времени через события WebSocket.
Выбор по форме API
Разные возможности используют разные способы передачи и получения результата. Клиент должен обрабатывать данные согласно Content-Type и типу ответа на странице endpoint.
| Форма API | Типичные сценарии | Обработка на клиенте |
|---|---|---|
| Синхронный JSON | Обычный текст, Embedding, Rerank | Разобрать JSON после завершения запроса |
| Потоковый ответ SSE | Потоковая генерация Chat, Responses, Gemini | Непрерывно читать события до конца потока |
| Асинхронная задача | Видео, Midjourney | Сохранить ID задачи, запрашивать статус и результат |
| Загрузка Multipart | Редактирование изображений, транскрипция аудио | Загрузить файлы и поля формы по требованиям endpoint |
| Бинарный ответ | Загрузка видео или аудио | Сохранить файл согласно типу медиа |
| WebSocket | Realtime | Установить постоянное соединение для обмена событиями |
Как читать страницу endpoint
Проверьте Endpoint и аутентификацию
Проверьте Method, Path, адрес API и необходимые Header аутентификации. Общие правила приведены в Общих соглашениях.
Выберите сценарий запроса
Выберите пример, наиболее близкий к вашей задаче, затем настройте поля по Request Body, Path Parameters или Query Parameters.
Проверьте ответы и ошибки
Разбирайте результат по статусу HTTP и типу медиа. При ошибке сохраняйте обезличенные сведения и Request ID, если он присутствует в ответе, и обратитесь к Устранению неполадок.
Проверьте через Try It
Онлайн-отладка использует адрес API на этой странице. Введите ключ API текущего аккаунта и выберите доступную модель из списка. Не используйте постоянный производственный ключ на общих устройствах.
Общие правила интеграции
- Если вы не уверены, какой текстовый протокол выбрать, прочитайте Выбор протокола.
- Замените
MODEL_IDв примерах справочника на ID модели, фактически доступной текущему ключу API. - Одноимённые возможности могут поддерживать разные поля в разных моделях и протоколах; ориентируйтесь на текущий endpoint, права аккаунта и фактический ответ.
- Производственные приложения не должны встраивать ключ API в браузерный frontend или клиентский пакет. Try It предназначен только для временной отладки; не записывайте ключ в публичные репозитории, снимки экрана или журналы.
Далее: Общие соглашения · Ключ API, Base URL и аутентификация