gpt-imagegpt-image-2
gpt-image-2 · 生成圖片
圖片 / GPT / gpt-image-2 / 生成圖片
POST
/v1/images/generations請求參數
Authorization
在 Header 加入參數 Authorization,其值為 Bearer 之後拼接你的 API Key。
Authorization: Bearer ****************
Header 參數
Content-Typestring可選
application/json
Acceptstring可選
application/json
Body 參數application/json必填
modelstring必需
模型 ID,固定為 `gpt-image-2`
promptstring必需
圖像描述
ninteger可選
生成張數,預設 `1`
sizestring可選
解析度,如 `1024x1024`
qualitystring可選
品質檔位(模型支援時)
response_formatstring可選
回傳格式。`url` 僅對支援的模型(如 DALL-E 系列)生效;OpenAI gpt-image 一律回傳 `b64_json` 並忽略此欄位。
output_formatstring可選
輸出圖像編碼格式(png / jpeg / webp);對 OpenAI gpt-image 模型生效。
output_compressioninteger可選
壓縮等級 0–100;僅 jpeg / webp 生效。
backgroundstring可選
背景類型(transparent / opaque / auto);transparent 需搭配 png 或 webp。
moderationstring可選
內容審核嚴格度(auto / low);仍由上游審核。
userstring可選
用戶端可選傳入的最終使用者識別碼,用於上游濫用偵測。
範例
{ "model": "gpt-image-2", "prompt": "一隻在雪地裡奔跑的黃金獵犬", "n": 1, "size": "1024x1024", "response_format": "b64_json"}請求範例程式碼
curl https://api.starmodel.ai/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "一隻在雪地裡奔跑的黃金獵犬", "n": 1, "size": "1024x1024", "response_format": "b64_json" }'回應
200 · 成功
createdinteger可選
建立時間戳(秒)
dataarray[object]必需
生成的圖片列表
範例
{ "created": 1730000000, "data": [ { "b64_json": "<base64>" } ]}
