Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "happyhorse-1.0",
    "action": "text-to-video",
    "prompt": "A cinematic city scene at night",
    "duration": 10,
    "resolution": "1080P",
    "aspect_ratio": "16:9"
  }'
  • Публичное имя модели: happyhorse-1.0
  • Используйте action для выбора text-to-video, image-to-video, reference-to-video или video editing
  • Если action не указан, запрос с first-frame изображением считается image-to-video, иначе text-to-video
  • Асинхронное управление задачами через стандартный эндпоинт статуса video task

​
Авторизация

​
Authorization
string
обязательно
Все запросы требуют Bearer Token.
Authorization: Bearer YOUR_API_KEY

​
Тело запроса

​
model
string
по умолчанию:"happyhorse-1.0"
обязательно
Название модели генерации видео. Фиксированное значение: happyhorse-1.0.
​
action
string
по умолчанию:"text-to-video"
Режим генерации.Варианты:
  • text-to-video
  • image-to-video
  • reference-to-video
  • video-edit
​
prompt
string
Текстовое описание видео. Обязательно для text-to-video, reference-to-video и video-edit.
​
image_urls
string[]
URL first-frame изображения для image-to-video. Используется только первое изображение.Также принимаются совместимые поля: input_reference, images, image или image_with_roles[{ role: "first_frame" }].
​
reference_images
string[]
URL reference изображений. Для reference-to-video требуется от 1 до 9 изображений; для video-edit можно передать до 5.
​
url
string
URL входного видео для редактирования. Обязательно при action=video-edit.
​
audio_setting
string
по умолчанию:"auto"
Управление аудио для video-edit: auto или origin.
​
duration
integer
по умолчанию:5
Длительность видео в секундах. Диапазон: 3–15.
​
resolution
string
по умолчанию:"1080P"
Разрешение видео: 720P или 1080P.
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон для text-to-video: 16:9, 9:16, 1:1, 4:3, 3:4.
​
seed
integer
Random seed для воспроизводимой генерации.
​
watermark
boolean
по умолчанию:true
Добавлять ли watermark.
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "happyhorse-1.0",
    "action": "text-to-video",
    "prompt": "A cinematic city scene at night",
    "duration": 10,
    "resolution": "1080P",
    "aspect_ratio": "16:9"
  }'

​
Проверка задачи

Эндпоинт создания возвращает task ID. Используйте стандартный video task status endpoint для получения результата: 
curl --request GET \
  --url https://toapis.com/v1/videos/generations/{task_id} \
  --header "Authorization: Bearer YOUR_API_KEY"