الانتقال إلى المحتوى الرئيسي
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>"
    }
  ]
}
استخدم هذا المسار لتحرير الصور الموجودة باستخدام عمليات رفع multipart المتوافقة مع OpenAI على CometAPI.

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

  • لديك بالفعل صورة مصدر وتريد إجراء تعديل موجّهًا بواسطة Prompt
  • قد تحتاج إلى mask لإجراء تغييرات مستهدفة
  • يمكنك التعامل مع رفع ملفات multipart بدلًا من طلب JSON عادي

​
مسار التحقق الأول

  • ابدأ بملف PNG أو JPG واحد
  • تجاهل الـ mask حتى يعمل التدفق الأساسي للتحرير
  • استخدم تعليمة قصيرة واحدة تطلب تغييرًا مرئيًا واحدًا
  • توقّع زمن استجابة أطول من إنشاء الصور العادي

​
سلوك model

  • من الأفضل التعامل مع gpt-image-1 وgpt-image-1-mini وgpt-image-1.5 باعتبارها مسارات تحرير تعتمد أولًا على base64
  • يمكن لـ dall-e-3 إرجاع مخرجات URL عندما يدعم مسار المزوّد ذلك
  • يتبع qwen-image-edit سلوك التحرير الخاص بالمزوّد خلف مسار CometAPI نفسه
أكد التحقق المباشر بتاريخ 2026-03-13 أن طلب gpt-image-1 المعتمد على PNG نجح عند السماح بمهلة زمنية أطول. وقد أعادت الاستجابة usage.input_tokens وusage.output_tokens وusage.total_tokens وحمولة data[0].b64_json.

التفويضات

​
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-1

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

​
mask
file

Optional PNG mask. Transparent areas indicate regions that should be edited.

​
n
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 output format when supported by the selected model.

الخيارات المتاحة:
url,
b64_json
​
size
string

Requested output size when supported by the selected model.

الاستجابة

200 - application/json

Edited image result.

​
created
integer
مطلوب
​
data
object[]
مطلوب
​
usage
object