📌 gpt-image-1 API 全攻略 2025 / 04 / 28 版
～ ChatGPT 同級畫質、多模態生圖 & 看圖一次搞懂！～
━━━━━━━━━━━━━━━━━━━━━━
1️⃣ 什麼是 gpt-image-1 API？
• 原生多模態模型：同時具備「看圖」＋「生圖」能力，可描述、編輯或直接生成高品質影像，並能在圖中呈現可辨識文字。
• ChatGPT 同級畫質：正是 2025 年 3 月 ChatGPT 新增「生成圖像」功能所用的引擎，如今透過 Images API 對外開放。
• 產業採用：Adobe Firefly、Figma、Canva、GoDaddy、Instacart 等設計／電商工具已率先整合，快速產出海報、去背商品照、社群貼圖。
━━━━━━━━━━━━━━━━━━━━━━
2️⃣ 端點與基本參數
＝生成圖片＝
POST /v1/images/generations
model="gpt-image-1" ←必填
prompt ←必填
size：1024×1024 / 1024×1536 / 1536×1024
quality：low / medium / high / auto
style：vivid / natural
response_format：url / b64_json
moderation：auto / low
＝編輯圖片＝
POST /v1/images/edits
(參數同上，再加)
image：（URL 或 base64）
mask ：（選填）
＝理解圖片＝
POST /v1/chat/completions
model="gpt-image-1"
messages=[{
"role":"user",
"content":[
{"type":"image_url","image_url":{...}},
{"type":"text","text":"你的提問"}
]
}]
━━━━━━━━━━━━━━━━━━━━━━
3️⃣ 計價方式（美元）
文字輸入 token 5 / 百萬 token
影像輸入 token 10 / 百萬 token
影像輸出 token 40 / 百萬 token
▶️ 實測換算：
‧ 低畫質 ~0.02 美元／張
‧ 中畫質 ~0.07 美元／張
‧ 高畫質 ~0.19 美元／張
（token 統計與文字模型類似；發佈前請再次確認官方價格）
━━━━━━━━━━━━━━━━━━━━━━
4️⃣ 範例程式碼
4-1. 生成圖片（cURL）
curl https://api.openai.com/v1/images/generations \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-1",
"prompt": "清晨在九份山城的巷弄，一位提燈的老茶販，吉卜力風格，溫暖柔焦",
"size": "1024x1024",
"quality": "medium",
"style": "vivid",
"n": 1,
"response_format": "url"
}'
4-2. 前端 Fetch（建議透過後端 proxy 隱藏金鑰）
<script>
async function generateImage() {
const payload = {
model: "gpt-image-1",
prompt: "熊貓坐在台灣玉山頂喝珍珠奶茶，插畫風",
size: "1024x1024",
quality: "high",
style: "natural",
n: 1,
response_format: "url"
};
const res = await fetch("https://api.openai.com/v1/images/generations", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_BACKEND_PROXY_TOKEN"
},
body: JSON.stringify(payload)
});
const data = await res.json();
document.querySelector("#result").src = data.data[0].url;
}
</script>
<img id="result" width="512">
<button onclick="generateImage()">生圖！</button>
━━━━━━━━━━━━━━━━━━━━━━
5️⃣ 內容安全 & C2PA 標記
• 預設全程自動審查，違規內容會被攔截。
• 每張輸出圖均嵌入 C2PA 元資料（AI 生成標記），保證透明度。
• moderation 參數可選 auto（較嚴）或 low（較寬），仍需遵守使用政策。
━━━━━━━━━━━━━━━━━━━━━━
6️⃣ 提示語（Prompt）技巧
-
結構化描述：主體 ➜ 背景 ➜ 氣氛 ➜ 風格 ➜ 光影 ➜ 顏色。
-
引用參考風格：如「攝影棚商品照」「水彩插畫」，提升一致性。
-
明確限制：若需透明背景／特定比例／可讀文字，務必同時寫在 prompt 及參數（例：
background="transparent"、size="1024x1536"）。
━━━━━━━━━━━━━━━━━━━━━━
7️⃣ FAQ
Q：一次能生幾張？
A：n 最多 10；超量 API 會回錯誤。
Q：支援哪些輸出格式？
A：png（預設）、jpeg、webp。要透明背景請選 png 或 webp 並加 background="transparent"。
Q：能上傳圖來「轉風格」嗎？
A：可，使用 /images/edits，上傳原圖＋（可選）遮罩，在 prompt 說明欲轉成的風格。
Q：如何控制解析度與費用？
A：調整 size 與 quality。低品質草稿便宜又快，高品質定稿再升級。
━━━━━━━━━━━━━━━━━━━━━━
🔗 延伸閱讀（官方與新聞）
• OpenAI Images API 官方文件
• OpenAI 部落格〈Introducing GPT-Image-1〉
• The Verge：Figma、Canva 率先導入 gpt-image-1
• Adobe Firefly 部落格：如何整合 gpt-image-1 提升創作效率
—— 以上資訊歡迎分享／收藏，如有更新歡迎留言補充！ ——