توليد الصور Seedream

استخدم CometAPI POST /v1/images/generations لتوليد الصور من النص إلى الصورة ومن الصورة إلى الصورة باستخدام Seedream — مع دعم الإخراج المتسلسل لعدة صور والصور المرجعية.

POST /v1/images/generations

cURL

Text to Image (5.0)

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "a cat wearing a scarf sitting by the window watching rain, illustration style",
    "size": "2K",
    "response_format": "url",
    "watermark": false
  }' | jq -r '.data[].url'

200

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ],
  "usage": {
    "generated_images": 123,
    "output_tokens": 123,
    "total_tokens": 123
  },
  "model": "<string>"
}

​

نظرة عامة

أنشئ صورًا باستخدام نماذج Seedream من ByteDance عبر نقطة النهاية القياسية المتوافقة مع OpenAI /v1/images/generations. يدعم ذلك كلاً من توليد من النص إلى الصورة ومن الصورة إلى الصورة.

للاطلاع على القائمة الكاملة للنماذج، راجع صفحة النماذج. وللاطلاع على توثيق المعلمات التفصيلي من المزوّد، راجع توثيق VolcEngine.

عند استخدام التوليد المتسلسل (متعدد الصور)، اضبط sequential_image_generation على auto ويمكنك اختياريًا إعداد sequential_image_generation_options.max_images لتقييد عدد الصور الناتجة. يجب أن يكون إجمالي عدد الصور المرجعية بالإضافة إلى الصور المُولدة ≤ 15.

​

من الصورة إلى الصورة

مرّر صورة مرجعية واحدة أو أكثر عبر المعلمة image (مصفوفة من عناوين URL أو بيانات base64 بصيغة data URI) مع Prompt نصي. يدعم حتى 14 صورة مرجعية.

​

عنوان URL المُعاد يعطي AccessDenied؟

إن url المُعاد هو رابط موقّع لتخزين الكائنات ويحتوي على & ومحارف خاصة أخرى.
إذا نسخت JSON الخام ولصقته مباشرة في متصفح أو سكربت، فقد يؤدي الهروب في shell أو الاقتطاع في الطرفية إلى إزالة معلمات التوقيع، ما ينتج عنه:

\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}

كيفية الإصلاح:

• curl: مرّره عبر | jq -r '.data[].url' لاستخراج عنوان URL بشكل صحيح.
• Python: استخدم result.data[0].url أو image["url"] — السلسلة مكتملة بالفعل؛ مرّرها مباشرة إلى requests.get() أو webbrowser.open().
• JavaScript: الفكرة نفسها — result.data[0].url.
• عام: تأكد من أن & و% في عنوان URL لا يتم اقتطاعهما أو تهريبهما مرتين.

التفويضات

Authorization · string · header · مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json

Parameters for Seedream image generation (text-to-image and image-to-image).

model · string · افتراضي: doubao-seedream-5-0-260128 · مطلوب

Model to use. See the Models page for current Seedream model IDs.

prompt · string · افتراضي: a cat wearing a scarf sitting by the window · مطلوب

Text prompt describing the image to generate. Supports both Chinese and English. Recommended max 300 Chinese characters or 1000 English characters.

response_format · enum<string> · افتراضي: url

Output format. url returns a temporary image link (valid for 24 hours); b64_json returns base64-encoded image data.

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

size · string · افتراضي: 2048x2048

Output resolution. Presets 2K, 4K, or exact pixels like 2048x2048, 2304x1728, 2848x1600, 1600x2848, etc. Default: 2048x2048.

image · string[]

Reference image(s) for image-to-image generation. Each item is a public URL or base64 data URI (data:image/png;base64,...). Supports up to 14 reference images. Supported formats: jpeg, png, webp, bmp, tiff, gif.

watermark · boolean · افتراضي: true

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

guidance_scale · number · افتراضي: 2.5

Controls how closely the output follows the prompt. Higher values increase adherence but may reduce naturalness. Range: 1.0–10.0. Not supported by Seedream 5.0 (ignored).

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

Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation. Legacy parameter — ignored by newer models.

sequential_image_generation · enum<string> · افتراضي: disabled

Controls sequential (multi-image) generation mode.

• auto: model decides whether to generate a sequence based on the prompt
• disabled: always generate a single image

الخيارات المتاحة: auto, disabled

sequential_image_generation_options · object

Configuration for sequential (multi-image) generation. Only effective when sequential_image_generation is auto.

Show child attributes

output_format · enum<string> · افتراضي: jpeg

Output image file format. Options: png, jpeg.

الخيارات المتاحة: png, jpeg

الاستجابة

200 - application/json

Successful Response

created · integer · مطلوب

Unix timestamp (seconds) when the image was generated.

data · object[] · مطلوب

Array of generated image objects.

Show child attributes

usage · object · مطلوب

Resource usage information for this request.

Show child attributes

model · string

The model used for generation.