Быстрый старт
Получите ключ API и вызовите текстовые, графические и видеомодели с помощью минимальных примеров.
Получите ключ API и выполните минимальные запросы для текстового диалога, генерации изображений и видео.
Шаг 1: создайте аккаунт
Создайте аккаунт в AGTCloud; если аккаунт уже есть, войдите.
Шаг 2: получите ключ API
- Откройте API Keys.
- Нажмите Создать ключ API.
- Скопируйте ключ API и сохраните его в безопасном месте.
Безопасное хранение ключа API
Не сохраняйте полный ключ API в клиентской части браузера, открытых репозиториях, снимках экрана или журналах. При подозрении на утечку немедленно отзовите его.

Шаг 3: проверьте доступный баланс
Вызовы API расходуют средства аккаунта. Перед запросом проверьте доступный баланс на странице Баланс и пополнение; способы пополнения и результат зачисления смотрите в консоли.
Шаг 4: выполните первый вызов API
В примерах используются адрес API текущего сайта и демонстрационные модели. Перед вызовом проверьте в каталоге моделей, что соответствующая модель доступна текущему ключу API.
Диалог с LLM
Совместимый интерфейс Chat Completions можно вызывать через OpenAI SDK или HTTP-запросы.
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.agtcloud.cn/v1",
)
response = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[
{"role": "user", "content": "Здравствуйте! Что вы умеете?"}
],
)
print(response.choices[0].message.content)Текст ответа находится в choices[0].message.content. Дополнительные параметры смотрите в Chat Completions.
Генерация изображений
curl 'https://api.agtcloud.cn/v1/images/generations' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-api-key' \
--data '{
"model": "qwen-image",
"prompt": "Город будущего, парящий над морем облаков"
}'Генерация видео
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-api-key' \
--data '{
"model": "doubao-seedance-2-5-260628",
"prompt": "Космический корабль пролетает через голубую туманность"
}'После успешного создания сохраните task_id из ответа, затем запросите состояние и результат задачи:
curl 'https://api.agtcloud.cn/v1/video/generations/your-task-id' \
-H 'Authorization: Bearer your-api-key'Все поля и состояния задач смотрите в разделах Создание видео и Получение видео.
Защита ключа API в рабочей среде
your-api-key обозначает место для подстановки. В рабочем проекте получайте ключ API из серверных переменных окружения или сервиса управления секретами. Не добавляйте реальные ключи в репозиторий и не передавайте их в клиентскую часть браузера.
Чтобы проверить запрос в браузере, откройте Playground.
Шаг 5: изучите модели
Откройте каталог моделей и найдите подходящую модель. Перед вызовом проверьте поддерживаемые протоколы, параметры и права текущего аккаунта.
Следующие шаги
- Генерация изображений — Изучите генерацию и редактирование изображений.
- Генерация видео — Изучите создание видеозадач и получение их результатов.
- Обработка аудио — Изучите синтез речи, транскрипцию и перевод.
- Сторонние интеграции — Подключите AGTCloud в популярных инструментах разработки.
- Ошибки и устранение неполадок — Устраните распространённые ошибки запросов.