Integratiehandleidingen
Fouten
Prijzen & facturatie
Seedream-afbeeldingsgeneratie
Gebruik CometAPI POST /v1/images/generations voor Seedream text-to-image- en image-to-image-generatie — ondersteunt sequentiële uitvoer van meerdere afbeeldingen en referentieafbeeldingen.
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>"
}Overzicht
Genereer afbeeldingen met ByteDance’s Seedream-modellen via het standaard OpenAI-compatibele/v1/images/generations-endpoint. Ondersteunt zowel text-to-image- als image-to-image-generatie.
Voor de volledige modellenlijst, zie de Models page. Voor gedetailleerde parameterdocumentatie van de provider, zie de VolcEngine-documentatie.
sequential_image_generation in op auto en configureer je optioneel sequential_image_generation_options.max_images om het aantal uitvoerafbeeldingen te beperken. Het totale aantal referentieafbeeldingen plus gegenereerde afbeeldingen moet ≤ 15 zijn.Image-to-Image
Geef een of meer referentieafbeeldingen door via de parameterimage (array van URL’s of base64-data-URI’s) samen met een tekstprompt. Ondersteunt maximaal 14 referentieafbeeldingen.
Geeft de geretourneerde URL AccessDenied?
url is een ondertekende object-storage-link die & en andere speciale tekens bevat.Als je de ruwe JSON kopieert en deze direct in een browser of script plakt, kunnen shell-escaping of terminalafkapping de handtekeningparameters verwijderen, wat resulteert in:
\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}
- curl: gebruik een pipe via
| jq -r '.data[].url'om de URL netjes te extraheren. - Python: gebruik
result.data[0].urlofimage["url"]— de string is al volledig; geef deze direct door aanrequests.get()ofwebbrowser.open(). - JavaScript: hetzelfde idee —
result.data[0].url. - Algemeen: zorg ervoor dat
&en%in de URL niet worden afgekapt of dubbel worden ge-escaped.
Autorisaties
Bearer token authentication. Use your CometAPI key.
Body
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 Respons
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>"
}