Руководство по API модели Agnes
Без сторонних инструментов — прямой вызов видеомодели Agnes через HTTP, с полными примерами на Python
Предварительные требования
Перед вызовом API вам потребуется:
- Действующий Agnes API Key (получить на Agnes Cloud Platform)
- Базовые знания HTTP-запросов (примеры на Python, работает на любом языке)
API Endpoint
Аутентификация
Все API-запросы требуют Bearer Token аутентификации в заголовке:
Тело запроса
Отправьте POST-запрос со следующими JSON-параметрами:
{
"prompt": "A cat walking through a neon-lit Tokyo alley",
"duration": 5,
"resolution": "1080p",
"style": "cinematic",
"narration": true,
"narration_lang": "en",
"subtitles": true
}Справочник параметров
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| prompt | string | Да | Текст описания видео (английский или китайский), рекомендуется 20-200 символов |
| duration | number | Нет | Длительность видео в секундах, по умолчанию 5, диапазон 3-30 |
| resolution | string | Нет | Разрешение: 720p / 1080p, по умолчанию 1080p |
| style | string | Нет | Стиль видео: cinematic / anime / realistic / abstract |
| narration | boolean | Нет | Генерировать AI-озвучку, по умолчанию false |
| narration_lang | string | Нет | Язык озвучки: zh / en / ja / ko и др., требуется narration=true |
| subtitles | boolean | Нет | Генерировать субтитры, по умолчанию false |
Полный пример на Python
Полный пример на Python — отправка задачи, опрос статуса, получение видео:
import requests
API_KEY = "your_api_key_here"
url = "https://api.agnes-ai.com/v1/video/generate"
headers = {"Authorization": f"Bearer {API_KEY}"}
payload = {
"prompt": "A drone shot of a mountain lake at sunrise",
"duration": 8,
"resolution": "1080p",
}
resp = requests.post(url, json=payload, headers=headers)
task = resp.json()
print(f"Task ID: {task['task_id']}")
# Poll for result
status = requests.get(
f"https://api.agnes-ai.com/v1/video/status/{task['task_id']}",
headers=headers
)
print(status.json()['video_url'] if status.json().get('video_url')
else "Still generating...")Не хотите писать код?
Все вышеперечисленные API-вызовы — аутентификация, сборка параметров, опрос статуса, повторные попытки при ошибках — уже реализованы в Agnes Video Generator. Просто откройте браузер, введите идею и создайте видео одним кликом. Это самый простой способ использования видеомодели Agnes.
Попробовать Agnes Video Generator онлайн →Похожие страницы
Agnes AI Video Model Overview — Capabilities, Versions & Access | Free AI Video Guide
A complete overview of the Agnes AI video model: core capabilities, version differences, and access methods. From text-to-video to image-to-video, master the full picture.
Agnes Model Prompt Engineering — 5 Tips for Better Video Prompts | Free AI Video Guide
Master prompt engineering for the Agnes video model. From camera language to temporal description — 5 core principles with good/bad examples. Make AI understand your vision precisely.
Готовы начать создавать?
«Мировой уровень ИИ — для каждого.» — Брюс Ян. Полностью бесплатно, без кредитной карты, с нулевыми затратами начните создавать своё первое AI-видео.
Клонируйте GitHub репозиторий и запустите за 2 минуты