OpenAI
使用 GPT-Image-1 進行圖片編輯
在 CometAPI 中使用搭配 gpt-image-1 的 POST /v1/images/edits，透過遮罩、Prompt 與尺寸選項來編輯圖片，並與 OpenAI 的圖片編輯行為保持一致。
POST
/
v1
/
images
/
edits
Edit images
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=Add a small red ribbon to the paper boat.' \
--form image='@example-file' \
--form mask='@example-file'{
"created": 1773381100,
"usage": {
"input_tokens": 226,
"input_tokens_details": {
"image_tokens": 194,
"text_tokens": 32
},
"output_tokens": 4160,
"total_tokens": 4386
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}使用此路由可在 CometAPI 上透過與 OpenAI 相容的 multipart 上傳來編輯現有圖片。
適合在以下情況使用此路由
- 你已經有一張來源圖片，並希望透過 Prompt 進行編輯
- 你可能需要使用遮罩來進行針對性的變更
- 你可以處理 multipart 檔案上傳，而不是單純的 JSON 請求
首次驗證路徑
- 從一個 PNG 或 JPG 檔案開始
- 在基礎編輯流程可正常運作前，先不要使用遮罩
- 使用一條簡短指令，只要求一個可見的變更
- 預期延遲會比一般圖片生成更長
模型行為
gpt-image-1、gpt-image-1-mini與gpt-image-1.5最適合視為以 base64 優先的編輯路由dall-e-3在提供者路徑支援時可以回傳 URL 輸出qwen-image-edit在相同的 CometAPI 路由後方遵循提供者特定的編輯行為
在 2026-03-13 的即時驗證中已確認，使用 PNG 的
gpt-image-1 請求在允許較長 timeout 的情況下成功。回應中包含 usage.input_tokens、usage.output_tokens、usage.total_tokens，以及 data[0].b64_json payload。授權
Bearer token authentication. Use your CometAPI key.
主體
multipart/form-data
Source image file. Start with one PNG or JPG input for the simplest flow.
Edit instruction describing the change you want.
範例:
"Add a small red ribbon to the paper boat."
The image editing model to use. Choose a current model from the Models page.
Optional PNG mask. Transparent areas indicate regions that should be edited.
Number of edited images to return.
Quality setting for models that support it.
可用選項:
high, medium, low Requested output format when supported by the selected model.
可用選項:
url, b64_json Requested output size when supported by the selected model.
⌘I
Edit images
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=Add a small red ribbon to the paper boat.' \
--form image='@example-file' \
--form mask='@example-file'{
"created": 1773381100,
"usage": {
"input_tokens": 226,
"input_tokens_details": {
"image_tokens": 194,
"text_tokens": 32
},
"output_tokens": 4160,
"total_tokens": 4386
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}