Grok-Video 视频生成使用指南

Grok-Video 当前走统一 /v1/videos 视频任务端点，适合社媒短视频、口播素材和节奏更自由的分镜短片。

接口地址 & 模型

• 创建任务：POST https://www.yuzhixiaolongxia.com/v1/videos
• 查询任务：GET https://www.yuzhixiaolongxia.com/v1/videos/{task_id}
• 下载视频：GET https://www.yuzhixiaolongxia.com/v1/videos/{task_id}/content
• API 模型 ID：grok-video
• 令牌分组：sora-veo-grok-video

分组开通须知

视频模型属于受控分组 sora-veo-grok-video。创建令牌时如果看不到这个分组，联系 zhiyanck@gmail.com 开通。

模型口径

模型 ID	适合场景	推荐用法	当前售价
grok-video	社媒短视频、口播素材、节奏自由的视频	适合 10 / 15 / 30 秒分镜	0.431 元/秒

旧文档里“6/10 秒一档、15/20 秒一档、25/30 秒一档”的价格表不再作为当前对账依据。当前以模型广场售价和控制台调用日志为准。

参数表

参数	类型	必填	说明
model	string	是	固定为 grok-video
prompt	string	是	视频描述，建议写清分段动作
seconds	string/int	否	建议显式传，例如 10 / 15 / 30
duration	int	否	兼容字段；新接入优先用 seconds
size	string	否	目标尺寸/规格，是否生效以实际返回为准
image	string	否	单张参考图 URL/base64
images	string[]	否	多张参考图 URL/base64
input_reference	file/string	否	multipart 参考图文件，或兼容参考图字段

图生视频字段

当前请求字段使用 image、images 或 input_reference，不要只在 prompt 写“这张图片”。

文生视频示例

curl -X POST "https://www.yuzhixiaolongxia.com/v1/videos" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video",
    "prompt": "A street food vendor stir-frying spicy crawfish in a giant wok, flames jumping, crowd watching, neon city lights at night, handheld documentary feel, vertical short video",
    "seconds": "15"
  }'

查询：

curl "https://www.yuzhixiaolongxia.com/v1/videos/task_xxx" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

下载：

curl -L "https://www.yuzhixiaolongxia.com/v1/videos/task_xxx/content" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  --output grok-result.mp4

图生视频示例

curl -X POST "https://www.yuzhixiaolongxia.com/v1/videos" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video",
    "prompt": "Use image 1 as the scene reference. The camera slowly pans left to right, realistic motion, natural street light",
    "seconds": "10",
    "images": [
      "https://example.com/night-market.jpg"
    ]
  }'

multipart 本地文件：

curl -X POST "https://www.yuzhixiaolongxia.com/v1/videos" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "model=grok-video" \
  -F "prompt=Use the uploaded image as the scene reference. Slow handheld camera, realistic short video" \
  -F "seconds=10" \
  -F "input_reference=@scene.jpg"

计费与对账

Grok-Video 当前售价 0.431 元/秒，任务提交时预扣，任务失败后会回退预扣。

预扣金额 = 0.431 元/秒 × seconds × 尺寸系数

seconds	示例预扣
10	4.310 元
15	6.465 元
30	12.930 元

最终金额以控制台「调用日志」为准。

提示词技巧

Grok-Video 更适合写成自然的短视频分镜：

0-5s: A vendor pours crawfish into a hot wok, flames jump.
5-10s: Close-up of spices and steam, handheld camera.
10-15s: The finished dish is served, customer smiles to camera.

15 秒以上的视频不要塞太多动作。写 2-3 个关键镜头，比一句话列十几个动作更稳。

常见错误

错误/现象	原因	处理
model not found	模型 ID 写错	必须是 grok-video
prompt is required	没传 prompt	补 prompt
图生视频没参考图效果	没传图片字段	传 image、images 或 input_reference
401	令牌错误	重新创建令牌
403 quota_exceeded	余额不足	充值后重试
任务长时间 queued	队列等待	不要重复提交，等 3-5 分钟再看
task timeout	任务等待过久	等退款后降低 seconds，拆成多段短视频重试

上一步：Veo 3.1 视频生成使用指南　|　返回：视频生成总览