快速開始
三步用 API 生成第一張圖:取得金鑰、送出一個請求、讀取回傳的圖片,請求和回傳的欄位與 OpenAI Images API 相同。
API 的請求和回傳與 OpenAI Images API 相同。如果你已經在呼叫 OpenAI,換掉網址和金鑰,其餘程式碼不用動。
1. 取得 API 金鑰
登入後在 API 金鑰 頁面建立一把金鑰。新帳號有 5 張免費圖,API 也能用:限 GPT Image 2、2.5、2.6 的 1K 圖,每次 1 張。其他情況請先儲值。金鑰以 sk-cheap- 開頭,只在建立時顯示一次,請當場複製保存。
2. 送出請求
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "雪地裡的一隻紅狐",
"size": "1536x1024"
}'from openai import OpenAI
client = OpenAI(
base_url="https://api.cheapestimagen.com/v1",
api_key="YOUR_KEY",
)
result = client.images.generate(
model="gpt-image-2",
prompt="雪地裡的一隻紅狐",
size="1536x1024",
)import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.cheapestimagen.com/v1',
apiKey: process.env.YOUR_KEY,
});
const result = await client.images.generate({
model: 'gpt-image-2',
prompt: '雪地裡的一隻紅狐',
size: '1536x1024',
});3. 讀取圖片
回傳裡每張圖一項。預設每項用 b64_json 帶回圖片的 base64 資料:
{
"created": 1794660236,
"data": [{ "b64_json": "iVBORw0KGgo..." }]
}傳 "response_format": "url" 可以改為回傳圖片連結。連結裡的圖片保存 72 小時。
同步還是非同步
上面的請求是同步的:圖片生成完才回傳。如果請求時間長,或是要一次送出很多張,改用非同步方式:在請求裡加 "async": true,立刻拿到任務編號,之後再輪詢任務,也可以加 webhook_url,任務結束時我們回呼通知你。兩種方式價格相同。輪詢、批次查詢和回呼的寫法見同步請求和非同步請求。
怎麼收費
GPT Image 2、2.5、2.6 每張 8 積分;Nano Banana 2 和 2.1 每張 12 積分;Nano Banana Pro、gpt-image-2-adobe 以及 flare 版本每張 20 積分;sunburst 版本每張 25 積分;Nano Banana 穩定通道(-1k、-2k、-4k)每張 60 到 180 積分。尺寸和品質不影響價格(1 積分約 0.001 到 0.0018 美元,見 /zh-tw/pricing)。失敗的請求不收費:請求開始時預先扣除積分,沒有交付的圖片會退回。唯一的例外:Nano Banana 穩定通道(-1k、-2k、-4k)因內容違規被拒的圖照樣扣積分。