إنشاء تعديل صورة

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 واحد

تجاهل القناع حتى يعمل التدفق الأساسي للتعديل

استخدم model: "gpt-image-2" لطلبات تعديل صور GPT على هذا المسار

استخدم تعليمة قصيرة واحدة تطلب تغييرًا مرئيًا واحدًا

اقرأ النتيجة المعدّلة من data[0].b64_json

عيّن output_format: "jpeg" عندما تريد حمولة 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

استخدم هذا المسار عندما

أول طلب آمن

سلوك النموذج

التفويضات

الجسم

الاستجابة

​استخدم هذا المسار عندما

​أول طلب آمن

​سلوك النموذج

التفويضات

الجسم

الاستجابة

استخدم هذا المسار عندما

أول طلب آمن

سلوك النموذج