نماذج النص
نماذج الصور
نماذج الفيديو
إدارة المحتوى
تحرير الصور
استخدم POST /v1/images/edits في CometAPI لتحرير الصور عبر uploads متعددة الأجزاء، والأقنعة، ونماذج صور 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>"
}
]
}استخدم هذا المسار لتحرير الصور الموجودة باستخدام uploads متعددة الأجزاء المتوافقة مع OpenAI على CometAPI.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
- قد تحتاج إلى mask لإجراء تغييرات مستهدفة
- يمكنك التعامل مع رفع ملفات متعددة الأجزاء بدلًا من طلب JSON عادي
أول طلب آمن
- ابدأ بملف PNG أو JPG واحد
- تخطَّ الـ mask حتى يعمل تدفق التحرير الأساسي
- استخدم
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 نفسه
التفويضات
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>"
}
]
}