Guides d’intégration
Erreurs
Tarification et facturation
Génération d’images Seedream
Utilisez CometAPI POST /v1/images/generations pour la génération Seedream de texte vers image et d’image vers image — prend en charge la sortie séquentielle de plusieurs images et les images de référence.
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>"
}Vue d’ensemble
Générez des images à l’aide des modèles Seedream de ByteDance via l’endpoint standard compatible OpenAI/v1/images/generations. Prend en charge à la fois la génération text-to-image et image-to-image.
Pour la liste complète des modèles, consultez la page Models. Pour une documentation détaillée des paramètres du fournisseur, consultez la documentation VolcEngine.
sequential_image_generation sur auto et configurez éventuellement sequential_image_generation_options.max_images pour limiter le nombre d’images de sortie. Le nombre total d’images de référence et d’images générées doit être ≤ 15.D’image vers image
Transmettez une ou plusieurs images de référence via le paramètreimage (tableau d’URL ou d’URI de données base64) avec un Prompt textuel. Prend en charge jusqu’à 14 images de référence.
L’URL renvoyée affiche AccessDenied ?
url renvoyée est un lien signé de stockage d’objets qui contient & et d’autres caractères spéciaux.Si vous copiez le JSON brut et le collez directement dans un navigateur ou un script, l’échappement du shell ou la troncature du terminal peut supprimer les paramètres de signature, ce qui entraîne :
\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}
- curl : faites passer via
| jq -r '.data[].url'pour extraire l’URL proprement. - Python : utilisez
result.data[0].urlouimage["url"]— la chaîne est déjà complète ; transmettez-la directement àrequests.get()ouwebbrowser.open(). - JavaScript : même principe —
result.data[0].url. - Général : assurez-vous que
&et%dans l’URL ne sont ni tronqués ni échappés deux fois.
Autorisations
Bearer token authentication. Use your CometAPI key.
Corps
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 Réponse
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>"
}