Skip to main content
POST
Використовуйте цей endpoint, щоб запустити завдання Grok image-to-video з одного вихідного зображення та prompt. Він одразу повертає request_id, тому розглядайте це як перший крок в асинхронному workflow.

​
Почніть із невеликого запиту

  • Використовуйте model: grok-imagine-video-1.5
  • Встановіть image.url на публічний URL JPEG, PNG або WebP
  • Для першого запиту залиште duration на 1, а resolution на 720p
  • Зберігайте prompt явним, щоб напрямок анімації був зрозумілим
  • Якщо надсилаєте base64, залишайте форму в документації та прикладі OpenAPI як data:image/png;base64,<BASE64_IMAGE_DATA>

​
Тривалість і роздільна здатність

​
Потік завдання

1

Створіть завдання

Надішліть prompt і вихідне зображення, а потім збережіть повернений request_id.
2

Опитуйте до завершення

Викликайте Отримання результатів xAI video, доки вкладений статус провайдера не стане done.
3

Збережіть результат

Скопіюйте фінальний video.url у власне сховище, якщо він потрібен вам після завершення тимчасового вікна доставки провайдера.

Авторизації

​
Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

application/json
​
prompt
string
обов'язково

Prompt describing how the source image should animate. CometAPI requires this field for this route.

Приклад:

"Animate the still image with a slow camera move and natural motion."

​
aspect_ratio
enum<string>

Output aspect ratio. Combine with resolution to choose the target frame; for example 480p with 1:1 targets 480x480, 720p with 16:9 targets 1280x720, and 720p with 9:16 targets 720x1280. This endpoint does not expose an exact size field.

Доступні опції:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
​
duration
integer
за замовчуванням:8

Output duration in seconds. Use an integer from 1 through 15. If omitted, CometAPI treats the request as an 8-second generation for billing and default handling.

​
image
object

Source image for image-to-video. Use a public JPEG, PNG, or WebP URL, or a data URI such as data:image/png;base64,<BASE64_IMAGE_DATA>.

​
model
string
за замовчуванням:grok-imagine-video-1.5

xAI video model id. The default example uses Grok Imagine 1.5 for image-to-video.

Приклад:

"grok-imagine-video-1.5"

​
output
object
​
resolution
enum<string>
за замовчуванням:720p

Output resolution. Use 720p for a small image-to-video test, or 1080p when you need a higher resolution tier.

Доступні опції:
480p,
720p,
1080p
​
size
string

Deprecated size field. Prefer aspect_ratio and resolution.

​
user
string

Optional end-user identifier.

Відповідь

200 - application/json

Request accepted.

​
request_id
string
обов'язково

Deferred request id used for polling.