画像編集を作成

curl https://api.cometapi.com/v1/images/edits \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F image=@cat.jpg \ -F prompt="Add a small red bow tie on the cat" \ -F model=gpt-image-2 \ -F quality=low

{ "created": 1781075000, "background": "opaque", "output_format": "png", "quality": "low", "size": "1024x1024", "usage": { "input_tokens": 784, "input_tokens_details": { "image_tokens": 768, "text_tokens": 16 }, "output_tokens": 196, "output_tokens_details": { "image_tokens": 196, "text_tokens": 0 }, "total_tokens": 980 }, "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." } ] }

安全な最初のリクエスト

まずは PNG または JPG ファイルを 1 つ使います

基本的な編集フローが動作するまでは mask を使わないでください

このルートでの GPT 画像編集リクエストには model: "gpt-image-2" を使用します

目に見える変更を 1 つだけ求める短い指示を 1 つ使います

編集後の結果は data[0].b64_json から読み取ります

JPEG ペイロードが必要な場合は output_format: "jpeg" を設定します

通常の画像生成よりレイテンシが長くなることを見込んでください

モデルの挙動

このルートの GPT 画像編集モデルは、インラインの base64 画像データを返します

output_format は b64_json 内でエンコードされる画像タイプを制御します

response_format が意味を持つのは、モデルが URL 出力をサポートしている場合のみです

qwen-image-edit は、同じ CometAPI ルートの背後でプロバイダー固有の編集挙動に従います

承認

Authorization

string

header

必須

Bearer token authentication. Use your CometAPI key.

ボディ

multipart/form-data

image

file

必須

Source image file. Start with one PNG or JPG input for the simplest flow.

prompt

string

必須

Edit instruction describing the change you want.

例:

"Add a small red ribbon to the paper boat."

model

string

デフォルト:gpt-image-2

The image editing model to use. Choose a supported model from the Models page.

mask

file

Optional PNG mask. Transparent areas mark the regions to edit. The mask dimensions must match the source image exactly.

string

デフォルト:1

Number of edited images to return.

quality

enum<string>

Quality setting for models that support it.

利用可能なオプション:

high,

medium,

low

response_format

enum<string>

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

output_format

string

Encoded image type for GPT image edit results returned in data[].b64_json. For example, use jpeg for a JPEG payload.

例:

"jpeg"

size

string

Requested output size when supported by the selected model.

レスポンス

200 - application/json

Edited image result.

created

integer

必須

usage

object

必須

Show child attributes

data

object[]

必須

Show child attributes

background

string

Background mode returned by models that expose it.

output_format

string

Encoded image type returned by GPT image models.

quality

string

Quality level returned by models that expose it.

size

string

Output size returned by models that expose it.

curl https://api.cometapi.com/v1/images/edits \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F image=@cat.jpg \ -F prompt="Add a small red bow tie on the cat" \ -F model=gpt-image-2 \ -F quality=low

コンテンツモデレーション

APIキー

このルートを使う場面

安全な最初のリクエスト

モデルの挙動

承認

ボディ

レスポンス

​このルートを使う場面

​安全な最初のリクエスト

​モデルの挙動

承認

ボディ

レスポンス

このルートを使う場面

安全な最初のリクエスト

モデルの挙動