Grok Imagine Video
通过异步媒体任务，使用文本提示词或图片调用 Grok Imagine Video 生成视频。
model=grok-imagine-video，mode=fast。支持 Txt2Video 与 Img2Video，时长 1～15 秒，分辨率支持 480p / 720p / 1080p，宽高比支持 1:1 / 2:3 / 3:2 / 16:9 / 9:16 / auto。
异步任务流程
- 准备输入素材。图生视频的
input.images必须使用公网可访问的 HTTPS 图片 URL。本地文件、Base64 / Data URL 或已有远程 URL，可以通过 U-Token 通用币 文件上传转为公开fileUrl。不得直接传入asset://、s3://、file://或内网地址。 - 创建任务。将下文说明的
task、model、mode和input字段发送到POST /v1/router/task/create。响应只保证返回tsk_*格式的平台task_id；其他成功字段来自当前上游，不能作为固定结构依赖。可选的callback_url会在任务结束时让 U-Token 通用币 POST 一次签名回调，见媒体任务回调。这个地址不会转发给上游。 - 轮询或取消。保存
task_id，每隔 3～5 秒调用GET /v1/router/tasks/{task_id}。如需停止排队中或处理中的任务，将{"task_id":"tsk_..."}发送到POST /v1/router/task/stop。API Key 只能查询或取消同一买家名下的任务。 - 读取结果。持续轮询直到任务进入终态：
| 状态 | 含义 |
|---|---|
0 | 排队中——任务已提交，等待调度 |
1 | 处理中——模型正在生成 |
2 | 已完成——输出 URL 通常位于 results[].urls；cost 为你的 credits 价格 |
3 | 失败——占用金额会释放，不会结算扣费 |
4 | 已取消——占用金额会释放，不会结算扣费 |
失败详情可能出现在 error_message、fail_reason 或 message，不要只依赖其中一个字段。固定价格会在任务创建时锁定，并在请求上游前从可用余额中暂时占用；只有成功后才会结算；失败或取消只释放占用金额，不会扣费。
结果 URL 约 24 小时后失效，请及时下载并保存。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
task | 是 | Txt2Video 或 Img2Video |
model | 是 | 固定为 grok-imagine-video |
mode | 是 | 必须为 fast；省略或传其他值都会被拒绝 |
input.prompt | 否 | 描述期望画面或运动效果的文本 |
input.images | 图生视频 | Img2Video 使用的公网 HTTPS 图片 URL 数组 |
input.duration | 是 | 1～15 的整数，单位为秒 |
input.resolution | 是 | 480p、720p 或 1080p |
input.aspect_ratio | 是 | 1:1、2:3、3:2、16:9、9:16 或 auto |
callback_url | 否 | 可选的公网 HTTPS 回调地址。见媒体任务回调。 |
计费
官方参考价按秒计算，最终买家价格还会应用账户当前配置的价格系数。
| 分辨率 | 官方参考价 |
|---|---|
480p | 2 credits/秒 |
720p | 3 credits/秒 |
1080p | 5 credits/秒 |
例如，6 秒 720p 任务的折扣前官方参考价为 18 credits；5 秒 1080p 任务的折扣前官方参考价为 25 credits。
请求示例
# 文生视频：720p、6 秒，应用价格系数前的官方参考价为 18 credits
curl https://u-token.ai/v1/router/task/create \
-H "Authorization: Bearer sk-你的KEY" -H "content-type: application/json" \
-d '{"task":"Txt2Video","model":"grok-imagine-video","mode":"fast",
"input":{"prompt":"一只猫在落日下冲浪","duration":6,"resolution":"720p","aspect_ratio":"16:9"}}'# 图生视频：1080p、5 秒，应用价格系数前的官方参考价为 25 credits
curl https://u-token.ai/v1/router/task/create \
-H "Authorization: Bearer sk-你的KEY" -H "content-type: application/json" \
-d '{"task":"Img2Video","model":"grok-imagine-video","mode":"fast",
"input":{"prompt":"让海浪和镜头产生动态效果","images":["https://assets.example.com/input.png"],"duration":5,"resolution":"1080p","aspect_ratio":"9:16"}}'