Grok Image

该模型已下线：CokeAPI 当前价目表中已不再提供 grok-4-1-image，调用会返回模型不存在错误。请迁移到 Gemini 3 Pro Image。本页仅作历史参考。

xAI

xAI 出品的图像生成模型,写实风格表现突出。通过 model 参数选择 grok-4-1-image(Grok 4.1)或 grok-4-2-image(Grok 4.2)。

文件上传提示:如需使用参考图片,请先通过文件上传接口上传图片获取 URL,再把 URL 放进 image_urls 参数。

调用示例

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4-1-image",
    "prompt": "一只在京都樱花树下的赛博狐狸,电影质感,Portra 400 胶片",
    "size": "16:9",
    "n": 1
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

img = client.images.generate(
    model="grok-4-1-image",
    prompt="一只在京都樱花树下的赛博狐狸,电影质感",
    size="16:9",
    n=1,
)

for d in img.data:
    print(d.url)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const img = await client.images.generate({
  model: "grok-4-1-image",
  prompt: "一只在京都樱花树下的赛博狐狸,电影质感",
  size: "16:9",
  n: 1,
});

img.data.forEach((d) => console.log(d.url));

请求参数

参数	类型	必填	默认值	说明
model	string	是	—	`grok-4-1-image`(Grok 4.1)或 `grok-4-2-image`(Grok 4.2)
prompt	string	是	—	英文 / 中文均可,最长 1000 字符
size	string	否	1:1	画面比例:`1:1` / `2:3` / `3:2` / `16:9` / `9:16`
n	int	否	1	一次出图数量:1 / 2 / 4,会根据数量预扣费
image_urls	string[]	否	—	参考图 URL 列表,最多 5 张。支持 jpeg/jpg/png/webp,单张不超过 10MB

响应示例

创建成功后立即返回任务状态,后续通过异步任务查询结果:

{
  "id": "img_01HX...",
  "object": "generation.task",
  "status": "queued",
  "progress": 0,
  "model": "grok-4-1-image",
  "created_at": 1718000000
}

计费

按 图片张数 × 单价 扣费。完整单价见模型列表。

错误码

code	type	含义	HTTP
400101	`invalid_param`	参数错误 (尺寸不支持等)	400
400401	`insufficient_balance`	余额不足	400
401104	`api_key_invalid`	API Key 无效	401
429101	`rate_limit_exceeded`	RPM 超限	429
429302	`daily_quota_exceeded`	每日调用配额耗尽	429
502201	`upstream_unavailable`	xAI 服务暂不可用	502
502203	`no_available_account`	暂无可用账号	502

完整列表见错误码。

注意事项

CDN 图片 URL 24 小时后失效,需长期保存请下载到自有存储。
失败请求 (含上游 502) 全额返还本次扣费,不计费。

调用示例

请求参数

响应示例

计费

错误码

注意事项

本页目录