Skip to main content
POST
Gunakan rute POST /v1/images/generations CometAPI yang kompatibel dengan OpenAI untuk menjalankan pembuatan gambar Seedream. Endpoint ini mendukung Prompt text-to-image, permintaan gambar referensi, dan output gambar berurutan yang dibatasi ketika model yang dipilih mendukung kontrol tersebut. Halaman ini membahas seedream-5-0-pro-260628 untuk permintaan Pro text-to-image dan seedream-5-0-260128 untuk contoh Seedream 5.0 gambar referensi, berurutan, dan async. Untuk ketersediaan akun, lihat halaman Models atau kueri /v1/models. Untuk detail parameter provider, lihat image generation API dan tutorial Seedream 4.0-5.0 dari BytePlus.

​
Pilih bentuk permintaan

  • Text to image: kirim model, prompt, size, dan kontrol output opsional seperti response_format, output_format, dan watermark.
  • Image to image: tambahkan image sebagai array URL HTTPS publik atau data URI. Gunakan array bahkan saat Anda mengirim satu gambar referensi.
  • Sequential prompt: atur sequential_image_generation ke auto dan gunakan sequential_image_generation_options.max_images sebagai batas atas. Model dapat mengembalikan lebih sedikit gambar daripada jumlah maksimum.
  • Async task: tambahkan async: true saat Anda ingin permintaan create mengembalikan data.task_id alih-alih menahan koneksi HTTP tetap terbuka.
Gambar referensi ditambah gambar yang dihasilkan harus tetap berada dalam batas provider. Pastikan permintaan berurutan tetap dibatasi dengan max_images.

​
Menjalankan task gambar async

Atur async ke true untuk job gambar yang harus dikirim dan dipoll oleh klien Anda. Permintaan create mengembalikan data.task_id; gunakan nilai tersebut dengan Retrieve a Seedream image task hingga data.status menjadi success atau failure. Gunakan 2K dalam contoh async untuk permintaan Seedream 5.0. Dukungan ukuran berbeda menurut model ID, jadi pilih ukuran yang didukung model sebelum Anda mengirim task async.

​
Mengirim gambar referensi

Gunakan data:image/png;base64,YOUR_BASE64_IMAGE untuk data gambar inline, atau gunakan URL HTTPS publik yang dapat diambil oleh provider. Contoh referensi API menunjukkan bentuk JSON lengkap untuk setiap jenis permintaan.

​
Membaca URL output

url yang dikembalikan adalah tautan object-storage bertanda tangan dan dapat berisi &, %, serta karakter khusus lainnya. Ekstrak URL dari JSON yang sudah diparse alih-alih menyalin sebagian baris terminal. Dalam contoh shell, jq -r '.data[]?.url' mempertahankan URL bertanda tangan lengkap.

Otorisasi

​
Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json

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

​
model
string
default:seedream-5-0-pro-260628
wajib

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

​
prompt
string
default:A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.
wajib

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>
default:url

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

Opsi yang tersedia:
url,
b64_json
​
size
string
default: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
default:false

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

​
async
boolean
default: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>
default:png

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

Opsi yang tersedia:
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.

Rentang yang diperlukan: 1 <= x <= 10
​
seed
integer
default:-1

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

Rentang yang diperlukan: -1 <= x <= 2147483647
​
sequential_image_generation
enum<string>
default: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.

Opsi yang tersedia:
auto,
disabled
​
sequential_image_generation_options
object

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

Respons

200 - application/json

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

​
created
integer
wajib

Unix timestamp in seconds when the image response was created.

​
data
object[]
wajib

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

​
usage
object

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