Guide all'integrazione
Prezzi e fatturazione
Generazione di immagini Seedream
Usa CometAPI POST /v1/images/generations per la generazione text-to-image e image-to-image di Seedream — supporta output multi-immagine sequenziali e immagini di riferimento.
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>"
}Panoramica
Genera immagini usando i modelli Seedream di ByteDance tramite l’endpoint standard compatibile con OpenAI/v1/images/generations. Supporta sia la generazione text-to-image sia image-to-image.
Per l’elenco completo dei modelli, consulta la pagina Models. Per la documentazione dettagliata dei parametri del provider, consulta la documentazione VolcEngine.
sequential_image_generation su auto e configura facoltativamente sequential_image_generation_options.max_images per limitare il numero di immagini in output. Il numero totale di immagini di riferimento più immagini generate deve essere ≤ 15.Image-to-Image
Passa una o più immagini di riferimento tramite il parametroimage (array di URL o data URI base64) insieme a un prompt testuale. Supporta fino a 14 immagini di riferimento.
L’URL restituito mostra AccessDenied?
url restituito è un link firmato di object storage che contiene & e altri caratteri speciali.Se copi il JSON grezzo e lo incolli direttamente in un browser o in uno script, l’escaping della shell o il troncamento del terminale potrebbero rimuovere i parametri della firma, causando:
\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}
- curl: usa una pipe con
| jq -r '.data[].url'per estrarre correttamente l’URL. - Python: usa
result.data[0].urloimage["url"]— la stringa è già completa; passala direttamente arequests.get()owebbrowser.open(). - JavaScript: stessa idea —
result.data[0].url. - Generale: assicurati che
&e%nell’URL non vengano troncati o sottoposti a escaping due volte.
Autorizzazioni
Bearer token authentication. Use your CometAPI key.
Corpo
Parameters for Seedream image generation (text-to-image and image-to-image).
Model to use. See the Models page for current Seedream model IDs.
Text prompt describing the image to generate. Supports both Chinese and English. Recommended max 300 Chinese characters or 1000 English characters.
Output format. url returns a temporary image link (valid for 24 hours); b64_json returns base64-encoded image data.
url, b64_json Output resolution. Presets 2K, 4K, or exact pixels like 2048x2048, 2304x1728, 2848x1600, 1600x2848, etc. Default: 2048x2048.
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.
When true, adds an 'AI Generated' watermark to the bottom-right corner of the output image.
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).
Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation. Legacy parameter — ignored by newer models.
Controls sequential (multi-image) generation mode.
auto: model decides whether to generate a sequence based on the promptdisabled: always generate a single image
auto, disabled Configuration for sequential (multi-image) generation. Only effective when sequential_image_generation is auto.
Show child attributes
Show child attributes
Output image file format. Options: png, jpeg.
png, jpeg Risposta
Successful Response
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>"
}