الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
images
/
edits
bytedance-Image Editing (seededit)
curl --request POST \
  --url https://api.cometapi.com/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form image='@example-file' \
  --form 'prompt=Put on glasses'
{
  "model": "<string>",
  "created": 123,
  "data": [
    {
      "url": "<string>"
    }
  ],
  "usage": {
    "generated_images": 123,
    "output_tokens": 123,
    "total_tokens": 123
  }
}

نظرة عامة

حرّر الصور باستخدام نموذج SeedEdit من ByteDance عبر نقطة النهاية القياسية المتوافقة مع OpenAI /v1/images/edits. طبّق تعديلات موجّهة عبر Prompt، وأقنعة، وتغييرات مختلفة. للاطلاع على توثيق المعلمات بالتفصيل، راجع توثيق VolcEngine SeedEdit.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

multipart/form-data
image
file
مطلوب

Incoming images need to fulfill the following conditions: Image format: jpeg, png. Aspect ratio (width/height): in the range (1/3, 3). Aspect length (px) > 14. Size: no more than 10MB.

prompt
string
مطلوب

A text description of the desired image(s).

  • Max length: 1000 chars for dall-e-3, 32000 chars for gpt-image-1.
مثال:

"Put on glasses"

model
string

Model to use: bytedance-seedEdit-3.0-i2i, doubao-seededit-3-0-i2i-250628, seedream-4-0-250828

مثال:

"bytedance-seedEdit-3.0-i2i"

response_format
enum<string>

Response format. Options: "url" or "b64_json". Only "dall-e-3" supports "url" (valid for 60 minutes).

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

Output image size. Use adaptive to match the input image dimensions.

مثال:

"adaptive"

seed
integer
افتراضي:-1

Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation.

guidance_scale
number

Controls how strongly the prompt influences the result vs. the input image. Range: 1.0–10.0. Higher values follow the prompt more closely.

watermark
boolean
افتراضي:true

When true, adds an 'AI Generated' watermark to the bottom-right corner of the output image.

الاستجابة

200 - application/json

success

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