Руководство по API модели Agnes

Без сторонних инструментов — прямой вызов видеомодели Agnes через HTTP, с полными примерами на Python

Предварительные требования

Перед вызовом API вам потребуется:

  • Действующий Agnes API Key (получить на Agnes Cloud Platform)
  • Базовые знания HTTP-запросов (примеры на Python, работает на любом языке)

API Endpoint

POST
https://api.agnes-ai.com/v1/video/generate

Аутентификация

Все API-запросы требуют Bearer Token аутентификации в заголовке:

// Authorization header
Authorization: Bearer YOUR_API_KEY

Тело запроса

Отправьте 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
}

Справочник параметров

ПараметрТипОбязательныйОписание
promptstringДаТекст описания видео (английский или китайский), рекомендуется 20-200 символов
durationnumberНетДлительность видео в секундах, по умолчанию 5, диапазон 3-30
resolutionstringНетРазрешение: 720p / 1080p, по умолчанию 1080p
stylestringНетСтиль видео: cinematic / anime / realistic / abstract
narrationbooleanНетГенерировать AI-озвучку, по умолчанию false
narration_langstringНетЯзык озвучки: zh / en / ja / ko и др., требуется narration=true
subtitlesbooleanНетГенерировать субтитры, по умолчанию 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 онлайн →

Похожие страницы

Готовы начать создавать?

«Мировой уровень ИИ — для каждого.» — Брюс Ян. Полностью бесплатно, без кредитной карты, с нулевыми затратами начните создавать своё первое AI-видео.

Клонируйте GitHub репозиторий и запустите за 2 минуты