画像編集
CometAPI の POST /v1/images/edits を使用して、multipart アップロード、マスク、GPT 画像モデル、エンコード済み画像出力の制御で画像を編集します。
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": 1776836647,
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 981,
"prompt_tokens_details": {
"cached_tokens_details": {}
},
"completion_tokens_details": {},
"input_tokens": 785,
"output_tokens": 196,
"input_tokens_details": {
"image_tokens": 768,
"text_tokens": 17,
"cached_tokens_details": {}
},
"claude_cache_creation_5_m_tokens": 0,
"claude_cache_creation_1_h_tokens": 0
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}このルートを使用すると、CometAPI で OpenAI 互換の multipart アップロードにより既存の画像を編集できます。Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
このルートを使う場合
- すでに元画像があり、プロンプト（Prompt）による編集を行いたい
- 対象を絞った変更のためにマスクが必要になる場合がある
- プレーンな JSON リクエストではなく multipart ファイルアップロードを扱える
安全な最初のリクエスト
- まずは PNG または JPG ファイルを 1 つ使う
- 基本的な編集フローが動作するまではマスクを省略する
- このルートでの GPT 画像編集リクエストには
model: "gpt-image-2"を使用する - 目に見える変更を 1 つだけ求める短い指示を使う
- 編集結果は
data[0].b64_jsonから読み取る - JPEG ペイロードが必要な場合は
output_format: "jpeg"を設定する - 通常の画像生成よりレイテンシが長くなることを見込む
モデルの挙動
- このルートの GPT 画像編集モデルは、インラインの base64 画像データを返す
output_formatはb64_json内のエンコード済み画像タイプを制御するresponse_formatは、モデルが URL 出力をサポートしている場合にのみ意味を持つqwen-image-editは、同じ CometAPI ルートの背後でプロバイダー固有の編集動作に従う
承認
Bearer token authentication. Use your CometAPI key.
ボディ
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 supported 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 response container when supported by the selected model. GPT image edit models return data[].b64_json; use output_format to choose the encoded image type.
url, b64_json Encoded image type for GPT image edit results returned in data[].b64_json. For example, use jpeg for a JPEG payload.
"jpeg"
Requested output size when supported by the selected model.
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": 1776836647,
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 981,
"prompt_tokens_details": {
"cached_tokens_details": {}
},
"completion_tokens_details": {},
"input_tokens": 785,
"output_tokens": 196,
"input_tokens_details": {
"image_tokens": 768,
"text_tokens": 17,
"cached_tokens_details": {}
},
"claude_cache_creation_5_m_tokens": 0,
"claude_cache_creation_1_h_tokens": 0
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}