> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Video 1.5 Preview Генерация

> Генерация видео 10s или 15s по одному reference изображению через grok-video-1.5-preview

* Только image-to-video. Text-to-video не поддерживается.
* Требуется ровно один публичный URL reference изображения.
* Поддерживаются видео длительностью `10` и `15` секунд.
* Поддерживаются только соотношения сторон `16:9` и `9:16`.
* Async task API: проверяйте статус видео по возвращенному task ID.

<Warning>
  Не передавайте base64 изображения. Сначала загрузите локальные файлы через [API загрузки изображений](../../uploads/images), затем передайте публичный URL в `images`.
</Warning>

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

<ParamField header="Authorization" type="string" required>
  Все API запросы требуют Bearer Token.

  ```text theme={null}
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

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

<ParamField body="model" type="string" default="grok-video-1.5-preview" required>
  Используйте `grok-video-1.5-preview`.
</ParamField>

<ParamField body="prompt" type="string" required>
  Опишите движение, камеру и визуальное направление для reference изображения.
</ParamField>

<ParamField body="images" type="string[]" required>
  Передайте ровно один публичный URL изображения.

  * Minimum: `1`
  * Maximum: `1`
  * Supported URL schemes: `http://`, `https://`
</ParamField>

<ParamField body="seconds" type="string" default="10">
  Длительность видео. Поддерживаемые значения: `"10"`, `"15"`.
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Соотношение сторон видео. Поддерживаемые значения: `16:9`, `9:16`.
</ParamField>

## Pricing

| Duration | Price             |
| -------- | ----------------- |
| `10s`    | `$0.10 / request` |
| `15s`    | `$0.15 / request` |

## Ответ

<ResponseField name="id" type="string">
  ID задачи для проверки статуса видео.
</ResponseField>

<ResponseField name="object" type="string">
  Тип объекта, всегда `generation.task`.
</ResponseField>

<ResponseField name="model" type="string">
  Название модели, использованной для задачи.
</ResponseField>

<ResponseField name="status" type="string">
  Статус задачи: `queued`, `in_progress`, `completed` или `failed`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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"
    }'
  ```
</RequestExample>

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

Используйте возвращенный `id` с [Video Task Status](../../tasks/video-status).