Seedream görüntüleri oluştur

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
  }
}

Seedream görsel üretimini çalıştırmak için CometAPI’nin OpenAI uyumlu POST /v1/images/generations rotasını kullanın. Bu endpoint, seçilen model bu kontrolleri desteklediğinde metinden görsele Prompt’ları, referans görsel isteklerini ve sınırlandırılmış sıralı görsel çıktısını destekler. Bu sayfa, Pro metinden görsele istekleri için seedream-5-0-pro-260628 modelini ve Seedream 5.0 referans görsel, sıralı ve async örnekleri için seedream-5-0-260128 modelini kapsar. Hesap erişilebilirliği için Models page sayfasına bakın veya /v1/models sorgulayın. Sağlayıcı parametre ayrıntıları için BytePlus image generation API ve Seedream 4.0-5.0 tutorial belgelerine bakın.

Bir istek biçimi seçin

Metinden görsele: model, prompt, size ve response_format, output_format ve watermark gibi isteğe bağlı çıktı kontrollerini gönderin.
Görselden görsele: image alanını herkese açık HTTPS URL’leri veya data URI’lerinden oluşan bir dizi olarak ekleyin. Tek bir referans görsel gönderiyor olsanız bile dizi kullanın.
Sıralı Prompt: sequential_image_generation değerini auto olarak ayarlayın ve sequential_image_generation_options.max_images alanını üst sınır olarak kullanın. Model, maksimum sayıdan daha az görsel döndürebilir.
Async görev: Oluşturma isteğinin HTTP bağlantısını açık tutmak yerine data.task_id döndürmesini istediğinizde async: true ekleyin.

Referans görseller ile üretilen görsellerin toplamı sağlayıcı sınırı içinde kalmalıdır. Sıralı istekleri max_images ile sınırlandırın.

Bir async görsel görevi çalıştırın

İstemcinizin gönderip sorgulaması gereken görsel işleri için async değerini true olarak ayarlayın. Oluşturma isteği data.task_id döndürür; data.status değeri success veya failure olana kadar bu değeri Bir Seedream görsel görevini getir ile kullanın. Async örneklerde Seedream 5.0 istekleri için 2K kullanın. Boyut desteği model ID’ye göre değişir, bu nedenle async görev göndermeden önce modelin desteklediği bir boyut seçin.

Referans görseller gönderin

Satır içi görsel verisi için data:image/png;base64,YOUR_BASE64_IMAGE kullanın veya sağlayıcının çekebileceği herkese açık bir HTTPS URL’si kullanın. API referans örnekleri, her istek türü için tam JSON yapısını gösterir.

Çıktı URL’lerini okuyun

Döndürülen url, imzalı bir object-storage bağlantısıdır ve &, % ve diğer özel karakterleri içerebilir. Kısmi bir terminal satırını kopyalamak yerine URL’yi ayrıştırılmış JSON’dan çıkarın. Shell örneklerinde jq -r '.data[]?.url' tam imzalı URL’yi korur.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json

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

model

string

varsayılan:seedream-5-0-pro-260628

gerekli

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

prompt

string

varsayılan:A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.

gerekli

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>

varsayılan:url

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

Mevcut seçenekler:

url,

b64_json

size

string

varsayılan: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

varsayılan:false

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

async

boolean

varsayılan: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>

varsayılan:png

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

Mevcut seçenekler:

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.

Gerekli aralık: 1 <= x <= 10

seed

integer

varsayılan:-1

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

Gerekli aralık: -1 <= x <= 2147483647

sequential_image_generation

enum<string>

varsayılan: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.

Mevcut seçenekler:

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

Yanıt

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

gerekli

Unix timestamp in seconds when the image response was created.

data

object[]

gerekli

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

Bir Replicate prediction alın

Bir Seedream görsel görevini alın

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
  }
}

İçerik moderasyonu

API anahtarları

Bir istek biçimi seçin

Bir async görsel görevi çalıştırın

Referans görseller gönderin

Çıktı URL’lerini okuyun

Yetkilendirmeler

Gövde

Yanıt

​Bir istek biçimi seçin

​Bir async görsel görevi çalıştırın

​Referans görseller gönderin

​Çıktı URL’lerini okuyun

Yetkilendirmeler

Gövde

Yanıt

Bir istek biçimi seçin

Bir async görsel görevi çalıştırın

Referans görseller gönderin

Çıktı URL’lerini okuyun