跳到內文
Cheapest Imagen

快速開始

三步用 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)因內容違規被拒的圖照樣扣積分。

本頁內容