Перейти к основному содержанию
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": "grok-video-1.5-preview",
    "prompt": "Animate this product photo into a cinematic commercial video",
    "images": ["https://example.com/product.jpg"],
    "seconds": "10",
    "aspect_ratio": "16:9"
  }'

{
  "id": "<string>",
  "object": "<string>",
  "model": "<string>",
  "status": "<string>"
}
  • Только image-to-video. Text-to-video не поддерживается.
  • Требуется ровно один публичный URL reference изображения.
  • Поддерживаются видео длительностью 10 и 15 секунд.
  • Поддерживаются только соотношения сторон 16:9 и 9:16.
  • Async task API: проверяйте статус видео по возвращенному task ID.
Не передавайте base64 изображения. Сначала загрузите локальные файлы через API загрузки изображений, затем передайте публичный URL в images.

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

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

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

​
model
string
по умолчанию:"grok-video-1.5-preview"
обязательно
Используйте grok-video-1.5-preview.
​
prompt
string
обязательно
Опишите движение, камеру и визуальное направление для reference изображения.
​
images
string[]
обязательно
Передайте ровно один публичный URL изображения.
  • Minimum: 1
  • Maximum: 1
  • Supported URL schemes: http://, https://
​
seconds
string
по умолчанию:"10"
Длительность видео. Поддерживаемые значения: "10", "15".
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видео. Поддерживаемые значения: 16:9, 9:16.

​
Pricing

DurationPrice
10s$0.10 / request
15s$0.15 / request

​
Ответ

​
id
string
ID задачи для проверки статуса видео.
​
object
string
Тип объекта, всегда generation.task.
​
model
string
Название модели, использованной для задачи.
​
status
string
Статус задачи: queued, in_progress, completed или failed.
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-1.5-preview",
    "prompt": "Animate this product photo into a cinematic commercial video",
    "images": ["https://example.com/product.jpg"],
    "seconds": "10",
    "aspect_ratio": "16:9"
  }'

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

Используйте возвращенный id с Video Task Status.