图片模型 API

Grok Imagine Image · API 接入

通过媒体任务接口接入 grok-imagine-image。包含请求示例、参数、鉴权和结果处理。

POST/v1/tasksMODELgrok-imagine-image

官方对应 grok-imagine-image核对 2026-09-27官方资料

代码示例与响应

请求与响应代码示例

POST/v1/tasks

服务端调用

curl "https://newrouters.com/v1/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  --data '{
  "model": "grok-imagine-image",
  "input": {
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "A small red house in a quiet garden"
  }
}'

服务端调用

const apiBaseUrl = "https://newrouters.com";
const apiKey = process.env.API_KEY;
if (!apiKey) throw new Error("Set API_KEY in your server environment");

const response = await fetch(apiBaseUrl + "/v1/tasks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + apiKey
  },
  body: JSON.stringify({
  "model": "grok-imagine-image",
  "input": {
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "A small red house in a quiet garden"
  }
})
});

const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);

服务端调用

import json
import os
from urllib.request import Request, urlopen

api_base_url = "https://newrouters.com"
api_key = os.environ["API_KEY"]
body = json.loads("{\"model\":\"grok-imagine-image\",\"input\":{\"resolution\":\"1k\",\"aspect_ratio\":\"auto\",\"output_format\":\"jpeg\",\"prompt\":\"A small red house in a quiet garden\"}}")

request = Request(
    api_base_url + "/v1/tasks",
    data=json.dumps(body).encode("utf-8"),
    headers={
    "Content-Type": "application/json",
    "Authorization": "Bearer " + api_key
    },
    method="POST",
)
with urlopen(request) as response:
    print(json.load(response))

平台地址已填入，运行前设置 API_KEY 环境变量。示例不会自动发起请求。

响应字段节选 · 示意值

202任务已受理

JSON

{
  "id": "TASK_ID",
  "status": "pending",
  "model": "grok-imagine-image",
  "result": null,
  "error": null
}

200成功结果

JSON

{
  "id": "TASK_ID",
  "status": "succeeded",
  "model": "grok-imagine-image",
  "result": {
    "assets": [
      "https://example.com/output.png"
    ]
  },
  "error": null
}

创建后如何查询结果

调用流程异步媒体任务

创建任务01
POST /v1/tasks
提交 model + input，保存返回的任务 id。
202 · pending
轮询状态02
GET /v1/tasks/{id}
pending / processing 时等待并继续查询。
等待 → 再查询
读取终态03
result.assets[] / error
按任务终态读取对应结果。
succeeded→ assetsfailed→ error

API 模型 ID 为 grok-imagine-image。本文说明平台的实际契约，调用前请核对实时目录中的可用性。

请求示例

平台地址在构建时填入，运行前设置 API_KEY 为服务端密钥。

curl "https://newrouters.com/v1/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  --data '{
  "model": "grok-imagine-image",
  "input": {
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "A small red house in a quiet garden"
  }
}'

查询结果

创建响应表示任务已受理，不是最终结果。用返回的 ID 替换 TASK_ID，轮询至 succeeded 或 failed。

curl "https://newrouters.com/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

成功查看 result，失败查看 error。上游结果未知时保留原任务 ID，不盲目重复提交付费生成。

参数说明

字段	类型	要求	默认值	限制
`images`	array	可选	—	—
`prompt`	string	必填	—	最大长度 100000
`resolution`	enum	可选	`"1k"`	`1k`, `2k`
`aspect_ratio`	enum	可选	`"auto"`	`auto`, `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`, `19.5:9`, `9:19.5`, `20:9`, `9:20`
`output_format`	enum	可选	`"jpeg"`	`png`, `jpeg`, `webp`

官方来源与模型身份

核对日期: 2026-09-27 · 平台模型: grok-imagine-image · 官方对应: grok-imagine-image

计费与排错

接入时核对当前可用性、契约和账号价格。排错时保留请求 ID 与消费凭据。完整 API 参考