메인 콘텐츠로 건너뛰기
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 with a subtle camera push-in",
    "images": ["https://example.com/product.jpg"],
    "seconds": "10",
    "aspect_ratio": "16:9"
  }'

{
  "id": "video_abc123def456",
  "object": "generation.task",
  "model": "grok-video-1.5-preview",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Image-to-video only. Text-to-video is not supported.
  • Requires exactly one public reference image URL.
  • Supports 10 and 15 second videos.
  • Supports only 16:9 and 9:16 aspect ratios.
  • Async task API: poll video task status with the returned task ID.
Do not pass base64 image data. Upload local files with the Upload 이미지 API, then pass the returned public URL in images.

​
Authorizations

​
Authorization
string
필수
All API requests require Bearer Token authentication.
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
기본값:"grok-video-1.5-preview"
필수
Use grok-video-1.5-preview.
​
prompt
string
필수
Describe the motion, camera movement, and visual direction for the reference image.
​
images
string[]
필수
Pass exactly one public image URL.
  • Minimum: 1
  • Maximum: 1
  • Supported URL schemes: http://, https://
​
seconds
string
기본값:"10"
Video duration.Supported values: "10", "15"
​
aspect_ratio
string
기본값:"16:9"
Video aspect ratio.Supported values: 16:9, 9:16

​
Pricing

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

​
응답

​
id
string
Task identifier for polling video status.
​
object
string
Object type, always generation.task.
​
model
string
모델 name used for the task.
​
status
string
Task status: queued, in_progress, completed, or failed.

​
Create a video task

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 with a subtle camera push-in",
    "images": ["https://example.com/product.jpg"],
    "seconds": "10",
    "aspect_ratio": "16:9"
  }'

{
  "id": "video_abc123def456",
  "object": "generation.task",
  "model": "grok-video-1.5-preview",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}

​
Query task status

Use the returned id with Video Task 상태.