Skip to main content
POST
/
v1
/
images
/
edits
curl -s https://api.cometapi.com/v1/images/edits \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seededit-3-0-i2i-250628",
  "image": "data:image/png;base64,YOUR_BASE64_IMAGE",
  "prompt": "Change the red square into a blue square and keep the background unchanged.",
  "response_format": "url",
  "size": "2K",
  "watermark": false
}' | jq -r '.data[]? | .url // .b64_json'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ],
  "usage": {
    "output_tokens": 123,
    "total_tokens": 123,
    "prompt_tokens": 123,
    "completion_tokens": 123
  }
}
استخدم مسار POST /v1/images/edits المتوافق مع OpenAI من CometAPI لتشغيل تحرير صور SeedEdit. تقبل نقطة النهاية هذه مراجع الصور بصيغة JSON أو عمليات رفع الملفات بنمط multipart، ويمكنها تطبيق تغييرات موجّهة عبر Prompt مع قناع اختياري. للاطلاع على model ID المتاحة، راجع صفحة Models أو استعلم عن /v1/models. ولمعرفة تفاصيل معلمات المزوّد، راجع توثيق VolcEngine SeedEdit.

​
اختر شكل طلب التعديل

  • تعديل JSON: أرسل model وimage وprompt وعناصر تحكم اختيارية مثل size وresponse_format وwatermark.
  • رفع Multipart: أرسل الحقول نفسها كأجزاء form وارفع image كملف.
  • تعديل باستخدام قناع: أضف mask كـ data URI أو عنوان URL عام عبر HTTPS أو ملف مرفوع. استخدم قناع PNG عالي التباين لتحديد منطقة التعديل.
استخدم 2K أو 4K أو 1K أو قيمة WIDTHxHEIGHT يدعمها model من أجل size. احذف size عندما تريد القيمة الافتراضية للمسار.

​
أرسل مدخلات الصور

في طلبات JSON، استخدم data:image/png;base64,YOUR_BASE64_IMAGE أو عنوان URL عامًا عبر HTTPS يمكن للمزوّد جلبه. أما في طلبات multipart، فارفع source.png أو أي ملف صورة مدعوم آخر مباشرةً.

​
اقرأ عناوين URL الناتجة

القيمة url المُعادة هي رابط موقّع لتخزين الكائنات، وقد تحتوي على & و% ومحارف خاصة أخرى. استخرج عنوان URL من JSON بعد تحليله بدلًا من نسخ سطر جزئي من الطرفية. في أمثلة shell، يحافظ jq -r '.data[]?.url' على عنوان URL الموقّع بالكامل.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Body

Parameters for SeedEdit image editing with JSON image inputs.

​
model
string
default:doubao-seededit-3-0-i2i-250628
required

SeedEdit model ID to use. Query /v1/models or open the Models page for available image editing model IDs.

​
image
string
default:data:image/png;base64,YOUR_BASE64_IMAGE
required

Source image to edit as a public HTTPS URL or a data URI such as data:image/png;base64,YOUR_BASE64_IMAGE. Use JPEG or PNG input and keep the file within the route size limit.

​
prompt
string
default:Change the red square into a blue square and keep the background unchanged.
required

Instruction describing the desired edit, such as Change the red square into a blue square and keep the background unchanged.

​
mask
string
default:data:image/png;base64,YOUR_BASE64_MASK

Optional mask image as a public HTTPS URL or data URI. Use a high-contrast PNG mask to mark the region that should receive the edit.

​
response_format
enum<string>
default:url

Response image format. Use url for a temporary signed image URL, or b64_json when you need base64 image data in the response.

Available options:
url,
b64_json
​
size
string
default:2K

Output resolution. Use a tier such as 1K, 2K, or 4K, or a model-supported WIDTHxHEIGHT value such as 2048x2048. Omit the field to use the route default.

​
seed
integer
default:-1

Optional random seed for reproducible attempts on model versions that support seeding. Use -1 or omit the field for a random seed.

Required range: -1 <= x <= 2147483647
​
guidance_scale
number

Optional prompt-adherence control for model versions that support it. Higher values can follow the prompt more closely but may reduce naturalness.

Required range: 1 <= x <= 10
​
watermark
boolean
default:false

When true, requests a visible AI-generated watermark on the output image. Set false when your workflow handles disclosure separately.

Response

200 - application/json

Successful response

​
created
integer
required

Unix timestamp in seconds when the image response was created.

​
data
object[]
required

Edited image results.

​
usage
object

Usage information for the request. Fields vary by model and route.