إنشاء صور Seedream

POST

images

generations

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro-260628",
  "prompt": "A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.",
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}' | jq -r '.data[]? | .url // .b64_json'

{
  "created": 1781075000,
  "data": [
    {
      "url": "https://<provider-cdn>/<file_id>.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 0
  }
}

استخدم مسار CometAPI المتوافق مع OpenAI POST /v1/images/generations لتشغيل إنشاء صور Seedream. تدعم نقطة النهاية هذه طلبات text-to-image، وطلبات الصور المرجعية، وإخراج الصور المتسلسل المحدود عندما يدعم model المحدد هذه العناصر التحكّمية. تغطي هذه الصفحة seedream-5-0-pro-260628 لطلبات Pro من نوع text-to-image وseedream-5-0-260128 لأمثلة الصور المرجعية والمتسلسلة وasync في Seedream 5.0. لمعرفة التوفر في الحساب، راجع صفحة Models أو استعلم عن /v1/models. وللاطلاع على تفاصيل parameters الخاصة بالموفّر، راجع image generation API من BytePlus ودليل Seedream 4.0-5.0.

اختر شكل الطلب

Text to image: أرسل model وprompt وsize وعناصر تحكم اختيارية في الإخراج مثل response_format وoutput_format وwatermark.
Image to image: أضف image كمصفوفة من عناوين URL عامة عبر HTTPS أو data URI. استخدم مصفوفة حتى عند إرسال صورة مرجعية واحدة.
Sequential prompt: اضبط sequential_image_generation على auto واستخدم sequential_image_generation_options.max_images كحد أقصى. يمكن أن يعيد model صورًا أقل من الحد الأقصى.
Async task: أضف async: true عندما تريد أن يعيد طلب الإنشاء data.task_id بدلًا من إبقاء اتصال HTTP مفتوحًا.

يجب أن تبقى الصور المرجعية بالإضافة إلى الصور المُنشأة ضمن الحد الذي يفرضه الموفّر. اجعل الطلبات المتسلسلة ضمن حدود باستخدام max_images.

شغّل مهمة صورة async

اضبط async على true للمهام الصورية التي ينبغي على العميل إرسالها ثم الاستعلام عنها. يعيد طلب الإنشاء data.task_id؛ استخدم هذه القيمة مع استرجاع مهمة صورة Seedream حتى تصبح data.status مساوية لـ success أو failure. استخدم 2K في أمثلة async لطلبات Seedream 5.0. يختلف دعم الأحجام حسب model ID، لذا اختر حجمًا مدعومًا من model قبل إرسال مهمة async.

أرسل صورًا مرجعية

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

اقرأ عناوين URL الخاصة بالمخرجات

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

التفويضات

Authorization

string

header

مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json

Parameters for Seedream image generation. Send JSON for text-to-image, image-to-image, and sequential prompt requests.

model

string

افتراضي:seedream-5-0-pro-260628

مطلوب

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

prompt

string

افتراضي:A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.

مطلوب

Text prompt describing the image or edit goal. Use a concrete visual request, such as a blue ceramic mug on a white table, soft studio lighting.

response_format

enum<string>

افتراضي:url

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

الخيارات المتاحة:

url,

b64_json

size

string

افتراضي:2K

Output resolution. Use a model-supported tier such as 2K or a model-supported WIDTHxHEIGHT value such as 2048x2048. Not every model ID accepts every tier.

image

string[]

Optional reference images for image-to-image generation. Each item can be a public HTTPS URL or a data URI such as data:image/png;base64,YOUR_BASE64_IMAGE. Use an array even for one image. Reference images plus generated images must not exceed the provider limit.

watermark

boolean

افتراضي:false

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

async

boolean

افتراضي:false

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll the Seedream image task endpoint GET /v1/images/generations/{task_id} for the final image data.

output_format

enum<string>

افتراضي:png

Output image file format. Use png when you need lossless output, or jpeg for smaller files.

الخيارات المتاحة:

png,

jpeg

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. Omit this field when you do not need model-specific tuning.

النطاق المطلوب: 1 <= x <= 10

seed

integer

افتراضي:-1

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

النطاق المطلوب: -1 <= x <= 2147483647

sequential_image_generation

enum<string>

افتراضي:disabled

Controls sequential prompt handling. Use auto to let the model return a sequence when the prompt calls for one. Use disabled for ordinary single-image requests.

الخيارات المتاحة:

auto,

disabled

sequential_image_generation_options

object

Options for sequential prompt handling. This object is only used when sequential_image_generation is auto.

Show child attributes

الاستجابة

200 - application/json

Image generation response. Synchronous requests return completed image data. Async requests return a task response with data.task_id.

Option 1
Async task response

created

integer

مطلوب

Unix timestamp in seconds when the image response was created.

data

object[]

مطلوب

Generated image results. The array can contain one or more images depending on the request and model response.

Show child attributes

usage

object

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

Show child attributes

الحصول على توقع Replicate

استرجاع مهمة صورة Seedream

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro-260628",
  "prompt": "A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.",
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}' | jq -r '.data[]? | .url // .b64_json'

{
  "created": 1781075000,
  "data": [
    {
      "url": "https://<provider-cdn>/<file_id>.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 0
  }
}

الإشراف على المحتوى

مفاتيح API

اختر شكل الطلب

شغّل مهمة صورة async

أرسل صورًا مرجعية

اقرأ عناوين URL الخاصة بالمخرجات

التفويضات

الجسم

الاستجابة

​اختر شكل الطلب

​شغّل مهمة صورة async

​أرسل صورًا مرجعية

​اقرأ عناوين URL الخاصة بالمخرجات

التفويضات

الجسم

الاستجابة

اختر شكل الطلب

شغّل مهمة صورة async

أرسل صورًا مرجعية

اقرأ عناوين URL الخاصة بالمخرجات