跳轉到主要內容
POST
文生图:根据文本提示词生成图片(官转)
🔒 需申請開通 GrokOfficial 分組:Grok Imagine 官轉不在 Default 預設分組,需申請開通後才能呼叫(含本頁 Playground)。未開通、或令牌計費模式為「按次計費」時,呼叫固定返回 503。申請流程見 Grok Imagine 官轉概覽 · 分組介紹。
右側的互動式 Playground 支援直接線上除錯。請在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),輸入 prompt,選擇模型、resolution、aspect_ratio(2.0 再選 quality)後一鍵傳送即可。
場景說明:本頁用於「文本生成圖片」,每次 1 張。本通道暫不開放圖片編輯,需要基於參考圖改圖或單次多張,請使用 Grok Imagine 官逆。
⚠️ 三個最容易踩的坑
  1. 用 resolution,不要用 size:size 不會被換算成解析度檔,傳了會按預設 1k 出圖和計費。
  2. 引數寫錯會報錯:resolution / aspect_ratio 不在列舉內返回 422,quality: "high" 返回 400——這與官逆通道「靜默回退」的行為相反。
  3. n 固定傳 1:需要多張請併發發起多次請求。
圖片 API 全部為同步呼叫:沒有非同步任務 ID,客戶端斷開連線結果即丟失、但請求仍會計費。grok-imagine-image-2.0 的 medium 檔 2K 約 60–80 秒,建議客戶端超時設到 360 秒,詳見 圖片 API 呼叫須知與最佳實踐。

程式碼示例

Python(OpenAI SDK 直連)

Python(原生 requests)

cURL

Node.js(原生 fetch)

引數說明速查

每張單價(與 xAI 官網一致):
模型價格與官網對齊,且可能隨官網調整;上表僅供參考,具體以頂部導航「模型價格」欄目為準:模型價格。

響應格式

  • data[] 裡每項只有 url 或 b64_json 二選一,取決於 response_format。
  • 返回的圖片連結請立即下載轉存,不要長期引用。
  • usage 是佔位值(prompt_tokens 恆為 1000 × 張數),不能用來核賬,以控制台賬單為準。
  • created 恆為 0,不要拿來計時。

相關文件

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key(令牌分组需包含 GrokOfficial)

主體

application/json
model
enum<string>
預設值:grok-imagine-image
必填

模型 ID:

  • grok-imagine-image —— 标准版,各分辨率均 $0.02/张
  • grok-imagine-image-quality —— 高质量版,1k / 1.5k / 2k 为 $0.05 / $0.06 / $0.07
  • grok-imagine-image-2.0 —— 新一代,low $0.04 / $0.05 / $0.06,medium $0.06 / $0.07 / $0.08
可用選項:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
prompt
string
必填

提示词,支持中英文。建议详细描述主体、场景、风格、光线

範例:

"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography"

n
enum<integer>
預設值:1

出图数量。本通道固定为 1,需要多张请并发调用

可用選項:
1
resolution
enum<string>
預設值:1k

分辨率档位(小写),决定计费档:1k(默认)/ 1.5k / 2k。

枚举外的值(如 4k、1K)返回 422。不要用 size 代替,size 不会被换算成分辨率档。

可用選項:
1k,
1.5k,
2k
aspect_ratio
enum<string>
預設值:1:1

输出宽高比,默认 1:1。实测示例:grok-imagine-image 的 1k + 3:2 输出 1248×832;-quality 的 2k + 9:16 输出 1584×2816。

枚举外的值(如 5:7)返回 422。

可用選項:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
quality
enum<string>

画质档,仅 grok-imagine-image-2.0 有效:low(默认)或 medium(单价高 $0.02,更慢)。

传 high 返回 400。另外两个模型不需要传。

可用選項:
low,
medium
response_format
enum<string>
預設值:url

返回格式:url(默认,图片链接,请立即下载转存)或 b64_json(纯 base64,不带 data: 前缀)

可用選項:
url,
b64_json

回應

成功生成图片

created
integer

恒为 0,不可用于计时

範例:

0

data
object[]

图片结果数组(本通道 1 项)

usage
object

占位值,不能用于核账。 prompt_tokens 恒为 1000 × 张数,真实扣费以控制台账单为准