الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
images
/
generations
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'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ],
  "usage": {
    "generated_images": 123,
    "output_tokens": 123,
    "total_tokens": 123
  },
  "model": "<string>"
}

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.

​
نظرة عامة

أنشئ الصور باستخدام نماذج Seedream من ByteDance عبر نقطة النهاية القياسية المتوافقة مع OpenAI /v1/images/generations. يدعم كلًا من توليد النص إلى صورة والصورة إلى صورة. للاطلاع على القائمة الكاملة للنماذج، راجع صفحة Models. وللاطلاع على توثيق المعلمات التفصيلي من المزوّد، راجع توثيق 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.

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

​
usage
object
مطلوب

Resource usage information for this request.

​
model
string

The model used for generation.