ToAPIsToAPIs
Grok Video

Grok 비디오 생성

Generate high-quality videos using Grok Video model

POST
/v1/videos/generations

중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.

  • Grok Video generation model
  • Select grok-video-1.0 model via the model parameter
  • Supports text-to-video and image-to-video
  • Async task management, query results via task ID

Important Change: For better performance and cost control, we no longer support passing base64 image data directly in reference_images. Please use the Upload 이미지 API to upload images first, then call this API with the returned URL.

Authorizations

Authorizationstring헤더필수

All API requests require Bearer Token authentication

Get API Key: Visit the API Key Management Page to obtain your API Key

Add to request headers:

Authorization: Bearer YOUR_API_KEY

Body

modelstring본문필수기본값: grok-video-1.0

Video generation model name

Supported models:

  • grok-video-1.0 - Grok video generation model

Example: "grok-video-1.0"

promptstring본문필수

Text description for video generation

durationinteger본문기본값: 8

Video duration in seconds

Supported range: 1–15 seconds

resolutionstring본문기본값: 720p

Video resolution

Supported values: 480p, 720p

aspect_ratiostring본문

Video aspect ratio

Supported formats:

  • 16:9 (landscape)
  • 9:16 (portrait)
  • 3:2 (landscape)
  • 2:3 (portrait)
  • 1:1 (square)
imagestring본문

Optional main image URL. Only public http:// or https:// URLs are supported.

reference_imagesstring[]본문

Array of reference image URLs for image-to-video generation

⚠️ Only URL format is supported (base64 is no longer supported)

  • Publicly accessible image URLs (http:// or https://)
  • Up to 8 images total across image and reference_images
  • Use the Upload 이미지 API to upload local images and get URLs

응답

idstring

Unique task identifier for querying task status

objectstring

Object type, always generation.task

modelstring

모델 name used

statusstring

Task status

  • queued - Waiting to be processed
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
created_atinteger

Task creation timestamp (Unix timestamp)

progressinteger

Task progress, usually 0 after submission

metadataobject

Task metadata

요청 예시

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-1.0",
    "prompt": "A golden retriever running on a green field in sunny weather",
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-1.0",
    "prompt": "Animate this dog running across the field",
    "reference_images": ["https://example.com/dog.jpg"],
    "duration": 10,
    "resolution": "480p",
    "aspect_ratio": "16:9"
  }'
import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "grok-video-1.0",
        "prompt": "A golden retriever running on a green field in sunny weather",
        "duration": 10,
        "resolution": "720p",
        "aspect_ratio": "16:9"
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")
const response = await fetch('https://toapis.com/v1/videos/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'grok-video-1.0',
    prompt: 'A golden retriever running on a green field in sunny weather',
    duration: 10,
    resolution: '720p',
    aspect_ratio: '16:9'
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

응답 예시

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