curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "生成一張橫版電影海報，未來城市夜景，霓虹燈，電影感構圖",
"n": 1,
"size": "16:9",
"resolution": "2k",
"quality": "high",
"response_format": "url"
}'
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "保留主體結構，把畫面改成賽博朋克風格，增強光影和細節",
"n": 1,
"size": "9:16",
"resolution": "4k",
"quality": "medium",
"image_urls": [
"https://example.com/source.png",
"https://example.com/source.png"
],
"response_format": "url"
}'
const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'gpt-image-2-vip',
prompt: 'Generate a cinematic widescreen poster of a futuristic neon city at night',
n: 1,
size: '16:9',
resolution: '2k',
quality: 'low',
response_format: 'url'
})
});
const task = await response.json();
console.log(task.id, task.status);
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gpt-image-2-vip",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}
GPT-Image-2-VIP
GPT-Image-2-VIP 圖像生成
使用 gpt-image-2-vip 模型生成圖像，參數與 gpt-image-2 一致，但支持全部常用寬高比
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "生成一張橫版電影海報，未來城市夜景，霓虹燈，電影感構圖",
"n": 1,
"size": "16:9",
"resolution": "2k",
"quality": "high",
"response_format": "url"
}'
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "保留主體結構，把畫面改成賽博朋克風格，增強光影和細節",
"n": 1,
"size": "9:16",
"resolution": "4k",
"quality": "medium",
"image_urls": [
"https://example.com/source.png",
"https://example.com/source.png"
],
"response_format": "url"
}'
const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'gpt-image-2-vip',
prompt: 'Generate a cinematic widescreen poster of a futuristic neon city at night',
n: 1,
size: '16:9',
resolution: '2k',
quality: 'low',
response_format: 'url'
})
});
const task = await response.json();
console.log(task.id, task.status);
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gpt-image-2-vip",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}
中國大陸用戶請注意： 中國大陸用戶請使用
https://toapis.cn 作為接口地址（Base URL）。文檔示例中的 https://toapis.com 請替換為 https://toapis.cn。- 統一的圖像生成 API 接口
- 通過
model參數選擇gpt-image-2-vip - 參數與
gpt-image-2保持一致 - 支持文生圖、單圖參考和多圖參考生成
- 異步任務管理，通過任務 ID 查詢結果
重要變更：爲了更好的性能和成本控制，我們不再支持在
image_urls / reference_images 中直接傳入 base64 圖片數據。請先使用 上傳圖片接口 上傳圖片，獲取 URL 後再調用本接口。Authorizations
string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key：訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加：
Authorization: Bearer YOUR_API_KEY
Body
string
預設值:"gpt-image-2-vip"
必填
圖像生成模型名稱示例：
"gpt-image-2-vip"string
必填
圖像生成的文本描述最長 32,000 個字符（GPT image models 官方上限）
string
預設值:"1:1"
輸出圖像比例支持以下預設比例：
1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21也支持使用 寬:高 格式傳入任意比例，例如 1:3、7:4，但必須符合下方的尺寸限制。也可以傳 auto 讓上游自動選擇尺寸，但最終寬高比和像素尺寸無法保證。string
預設值:"1k"
輸出分辨率檔位支持值：
1k、2k、4k任意分辨率
除上述預設比例外，可以通過size 的 寬:高 格式請求任意比例。服務端會根據 resolution 檔位計算實際像素尺寸，結果必須滿足：
- 寬和高都必須是 16 像素的倍數
- 長邊最大可達 3,840 像素（4K）
- 寬高比最大可達 3:1
- 像素總數範圍為 655,360–8,294,400
size: "1:3"、resolution: "2k"→1024x3072size: "7:4"、resolution: "1k"→1344x768
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "白色背景上的紅色圓形，簡潔測試圖",
"size": "1:3",
"resolution": "2k",
"quality": "medium",
"n": 1
}'
string
預設值:"medium"
圖片質量
low— 快速省錢，適合草稿/預覽medium— 平衡速度與質量high— 最高精度，適合正式出圖
string
預設值:"auto"
生成圖像的背景樣式
auto— 由模型自動決定（默認）transparent— 透明背景opaque— 不透明背景
透明背景建議搭配 PNG 輸出使用。
integer
預設值:1
生成圖像的數量默認：1
string
預設值:"url"
返回格式固定返回圖片 URL，推薦使用
urlstring[]
參考圖 URL 列表，用於圖生圖⚠️ 僅支持 URL 格式（不再支持 base64）
- 公開可訪問的圖片 URL（http:// 或 https://）
- 可使用 上傳圖片接口 上傳本地圖片獲取 URL
- 支持單圖和多圖參考
string[]
向後兼容的參考圖字段在 ToAPIs 中會自動歸一化爲
reference_imagesResponse
string
任務唯一標識符，用於查詢任務狀態
string
對象類型，固定爲
generation.taskstring
使用的模型名稱
string
任務狀態
queued- 排隊等待處理in_progress- 處理中completed- 成功完成failed- 失敗
integer
任務進度百分比（0-100）
integer
任務創建時間戳（Unix 時間戳）
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "生成一張橫版電影海報，未來城市夜景，霓虹燈，電影感構圖",
"n": 1,
"size": "16:9",
"resolution": "2k",
"quality": "high",
"response_format": "url"
}'
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "保留主體結構，把畫面改成賽博朋克風格，增強光影和細節",
"n": 1,
"size": "9:16",
"resolution": "4k",
"quality": "medium",
"image_urls": [
"https://example.com/source.png",
"https://example.com/source.png"
],
"response_format": "url"
}'
const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'gpt-image-2-vip',
prompt: 'Generate a cinematic widescreen poster of a futuristic neon city at night',
n: 1,
size: '16:9',
resolution: '2k',
quality: 'low',
response_format: 'url'
})
});
const task = await response.json();
console.log(task.id, task.status);
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gpt-image-2-vip",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}