AGTCloud API Docs
РуководстваСправочник APIИнтеграции и ресурсыОбновления и помощь

Быстрый старт

Получите ключ API и вызовите текстовые, графические и видеомодели с помощью минимальных примеров.

Получите ключ API и выполните минимальные запросы для текстового диалога, генерации изображений и видео.

Шаг 1: создайте аккаунт

Создайте аккаунт в AGTCloud; если аккаунт уже есть, войдите.

Шаг 2: получите ключ API

  1. Откройте API Keys.
  2. Нажмите Создать ключ API.
  3. Скопируйте ключ API и сохраните его в безопасном месте.

Безопасное хранение ключа API

Не сохраняйте полный ключ API в клиентской части браузера, открытых репозиториях, снимках экрана или журналах. При подозрении на утечку немедленно отзовите его.

Страница управления ключами API AGTCloud с отмеченными пунктом Ключи 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: изучите модели

Откройте каталог моделей и найдите подходящую модель. Перед вызовом проверьте поддерживаемые протоколы, параметры и права текущего аккаунта.

Следующие шаги

На этой странице