Grok 비디오 생성
Generate high-quality videos using Grok Video model
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
- Grok Video generation model
- Select
grok-video-1.0model 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_KEYBody
modelstring본문필수기본값: grok-video-1.0Video 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본문기본값: 8Video duration in seconds
Supported range: 1–15 seconds
resolutionstring본문기본값: 720pVideo 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
imageandreference_images - Use the Upload 이미지 API to upload local images and get URLs
응답
idstringUnique task identifier for querying task status
objectstringObject type, always generation.task
modelstring모델 name used
statusstringTask status
queued- Waiting to be processedin_progress- Processingcompleted- Successfully completedfailed- Failed
created_atintegerTask creation timestamp (Unix timestamp)
progressintegerTask progress, usually 0 after submission
metadataobjectTask 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": {}
}