Grok Imagine
使用此模型提交图片生成任务,再通过返回的任务 ID 查询结果。
模型 ID grok-imagine
快速开始
创建 并设置 I2V_API_KEY。每个新任务设置一个 IDEMPOTENCY_KEY,重试同一次提交时复用原幂等键和请求体。
提交任务
POST https://api.i2v.ai/api/v1/jobs/createTask
bash
curl "https://api.i2v.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $I2V_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "grok-imagine",
"inputs": {
"prompt": "A calm lake at sunrise",
"aspectRatio": "1:1"
}
}'HTTP 200 表示任务已受理。保存返回的 taskId。
json
{"taskId":"YOUR_TASK_ID"}查询结果
bash
curl "https://api.i2v.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY"将 YOUR_TASK_ID 替换为返回的任务 ID。状态为 waiting 或 generating 时退避轮询。success 时读取 output[].url,fail 时检查 error。
请求参数
模型输入放在 inputs 对象中。素材 URL 需要可公开访问。必需素材及参数组合取决于具体生成模式。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
inputs.prompt | string | 是 | — | 画面描述或编辑指令,写清主体、地点、光线与镜头。 上限 5000 字符. |
inputs.aspectRatio | string | 否 | 1:1 | 1:1、2:3、3:2、16:9、9:16;图生图模式下会被忽略。 可选值 1:1, 2:3, 3:2, 16:9, 9:16. |
inputs.imageUrls | string[] | 否 | — | 一张参考图,多传的部分会被丢弃。 上限 1 个 URL. |
请求顶层字段
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | grok-imagine | 公开模型 ID,使用本页显示的准确值。 |
maxCostUsd | string | 否 | — | 可选的美元费用上限,以最多八位小数的字符串传入。报价超出上限时会在生成前返回 HTTP 409。 |

