Skip to main content
POST
Playground
填入你的 API Key 和提示詞,然後傳送。這裡打的是線上介面,和你程式碼裡調的是同一個。
從這個頁面發出的請求是真實的,會計入你的 Key。 一張圖按模型和檔位不同約 $0.02 到 $0.08。這裡沒有沙箱,也沒有 mock。

參數

string
必填
用哪個模型。接受 grok-imagine-imagegrok-imagine-image-2.0grok-imagine-image-quality,精確匹配,沒有別名。
object
必填
生成參數。下面沒列出的鍵一律以 invalid_params 拒絕。
string
任務結束後把結果 POST 到這個地址,省掉輪詢。必須是 https, 其他形式在提交時就會被拒。

會返回什麼

提交立刻返回,一秒都用不到。圖片不在這個響應裡——生成是在後臺進行的。

然後輪詢取結果

這個 Playground 只覆蓋建立呼叫。拿上面響應裡的 id 去讀任務, 直到 status 變成 completedfailed——大約 7 到 10 秒。
完成的任務帶一個 outputs 陣列:
產物 URL 不鑑權,並且在任務完成 24 小時後失效。 usage.cost_in_usd_ticks原價,實際扣費是它乘以你所在分組的倍率—— 見計價

下一步

概覽

全部參數、解析度與品質的組合,以及實測時延。

非同步任務 API

輪詢閉環、回撥,以及完整錯誤表。