Grok Imagine 图像与视频生成 API 接入教程(grok-imagine-image / video)
Grok Imagine 是 xAI 的多模态生成系列:grok-imagine-image 负责文生图,grok-imagine-video 负责文生视频。它们都可以通过 OpenAI 兼容接口调用,本文给出完整示例。
一、模型清单
- grok-imagine-image-2.0:新一代文生图;
- grok-imagine-image:标准文生图;
- grok-imagine-image-quality:高质量档位;
- grok-imagine-video-1.5 与 grok-imagine-video:文生视频。
二、图像生成调用示例
curl https://route-api.site/v1/images/generations -H "Authorization: Bearer sk-你的密钥" -H "Content-Type: application/json" -d '{
"model": "grok-imagine-image-2.0",
"prompt": "一只橘猫坐在窗台上看雪,电影感光影",
"n": 1,
"size": "1024x1024"
}'
响应中 data[].url(或 b64_json)即图片。异步任务也可以走 /v1/images/generations/async 提交,再用任务 ID 轮询结果。
三、视频生成调用示例
curl https://route-api.site/v1/videos/generations -H "Authorization: Bearer sk-你的密钥" -H "Content-Type: application/json" -d '{"model": "grok-imagine-video-1.5", "prompt": "海边日落延时,浪花慢动作"}'
视频生成耗时较长,提交后返回任务 ID,通过 GET /v1/videos/:request_id 查询状态,完成后下载 content 视频。
四、费用与到账
图像与视频模型按官方参考价的 49% 计费。余额不足时在 充值页面 在线充值,支付成功后自动到账(约 1 分钟)。
五、常见问题
支持哪些尺寸? 按模型与上游支持为准,常见 1024x1024 / 720p 等;不支持时接口会返回参数错误。
生成慢怎么办? 用异步接口提交任务,稍后轮询,不占连接。
文字模型和图像模型共用一个 Key 吗? 是的,RouteAPI 一个 Key 调用全部模型(文本/图像/视频)。