OpenAI
GPT-Image-1 による画像編集
CometAPI で gpt-image-1 を使用して POST /v1/images/edits を利用し、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 アップロードにより既存画像を編集できます。
このルートを使う場合
- すでに元画像があり、プロンプト主導の編集を行いたい
- 特定箇所の変更のためにマスクが必要になる場合がある
- 通常の JSON リクエストではなく multipart のファイルアップロードを扱える
最初の検証手順
- まずは PNG または JPG ファイルを 1 つ使う
- 基本的な編集フローが動作するまではマスクを使わない
- 目に見える変更を 1 つだけ指示する短い命令を使う
- 通常の画像生成よりもレイテンシが長くなることを想定する
モデルの挙動
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 リクエストが成功することが確認されました。レスポンスには usage.input_tokens、usage.output_tokens、usage.total_tokens、および data[0].b64_json ペイロードが含まれていました。承認
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>"
}
]
}