Qualité d'image phare
Seedream 5 Pro rend des scènes photoréalistes, des packshots éditoriaux et du texte précis en 1K ou 2K — au niveau de GPT Image et NanoBanana.
Guide API Seedream 5 Pro
Seedream 5 Pro est le modèle image phare de ByteDance — excellent rendu de texte multilingue, édition multi-références et photoréalisme propre. Sur Seedance API, vous l'appelez comme un alias stable via des endpoints REST simples, avec polling asynchrone et tarification par image.
Sortie 1K ou 2K
1:1 à 16:9, 9:16, 2:3, 3:2
Prompt ou jusqu'à 10 images de référence
JSON sur HTTPS
Requête de démarrage
curl -X POST 'https://seedanceapi.org/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedream-5-pro",
"prompt": "Studio product shot of a matte black water bottle on wet stone, soft top light",
"aspect_ratio": "4:3",
"resolution": "2k",
"image_urls": []
}'POST /v1/images/generations renvoie un task_id. Pollez GET /v1/images/generations/:task_id jusqu'à SUCCESS, puis lisez images[].url.
Les équipes choisissent l'API Seedream 5 Pro quand elles veulent une qualité image phare derrière une surface REST prévisible — sans SDK fournisseur ni changements de schéma surprise.
Seedream 5 Pro rend des scènes photoréalistes, des packshots éditoriaux et du texte précis en 1K ou 2K — au niveau de GPT Image et NanoBanana.
Vous appelez model "seedream-5-pro". Routage, capacité et fallbacks restent de notre côté — votre intégration ne subit pas les changements amont.
9 crédits par image 1K, 18 par 2K, plus 0,8 par image de référence après la première. estimated_credits est renvoyé dans chaque réponse de création.
La surface publique expose ce que le modèle fait réellement : text-to-image et édition guidée par référence jusqu'à dix images.
Envoyez un prompt jusqu'à 3000 caractères avec ratio et résolution — le modèle gère composition, lumière et typographie dans l'image.
Passez 1–10 URLs HTTPS publiques dans image_urls pour éditer, composer ou restyler des visuels existants — remplacement produit, fond, transfert de style.
Mettez resolution à "2k" pour des rendus qualité print et des assets finaux. 1K suffit pour previews et itérations.
L'un des points forts du modèle — texte lisible en anglais, chinois, japonais et plus sur posters et enseignes.
La création renvoie immédiatement un task_id. Pollez le statut à votre rythme et gardez l'UI réactive — pas de connexions longues.
Le format de réponse reste stable quel que soit le routage amont — consumed_credits, status et URLs d'images sont normalisés.
Trois étapes de la clé API à l'URL d'image finale.
Connectez-vous, ouvrez la page API Keys et copiez une clé pour usage serveur. Gardez-la côté backend — jamais dans le code navigateur.
Appelez POST /v1/images/generations avec model "seedream-5-pro", votre prompt, aspect_ratio, resolution et image_urls optionnel. Vous recevez task_id et estimated_credits.
Appelez GET /v1/images/generations/:task_id. Quand status atteint SUCCESS, lisez images[0].url et affichez ou archivez le résultat.
Deux endpoints couvrent tout le cycle — création et polling.
Crée une tâche Seedream 5 Pro. image_urls vide = text-to-image ; 1–10 URLs = édition par référence. Réponse 202 avec task_id et estimated_credits.
Renvoie IN_PROGRESS, SUCCESS avec images[].url ou FAILED avec un objet erreur. Indique aussi consumed_credits une fois terminé.
400 paramètres invalides, 401 clé invalide, 402 crédits insuffisants, 404 tâche inconnue, 429 rate limit, 503 amont indisponible. Table complète dans la doc.
| Paramètre | Valeur |
|---|---|
| model | Doit être "seedream-5-pro" — le seul modèle public sur cette route. |
| prompt | Prompt texte ou instruction d'édition, 1–3000 caractères. |
| aspect_ratio | Un parmi 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2. Défaut 1:1. |
| resolution | "1k" (défaut, 9 crédits) ou "2k" (18 crédits). |
| image_urls | 0–10 URLs HTTPS publiques. Tableau vide = pur text-to-image. |
Les paramètres inconnus sont rejetés avec 400 UNKNOWN_PARAMETER — le contrat reste explicite. Schéma complet dans /docs/images.
Prix fixe par image en crédits Seedance API. La réponse de création inclut estimated_credits ; le statut final indique consumed_credits.
| Mode | Crédits | Notes |
|---|---|---|
| Text-to-image · 1K | 9 crédits / image | Résolution par défaut — pour itérations et previews. |
| Text-to-image · 2K | 18 crédits / image | Qualité print pour les assets finaux. |
| Édition par référence | +0,8 crédit / image en plus | Première référence incluse ; les images 2–10 ajoutent 0,8 chacune. |
Réponses pour les développeurs qui évaluent l'API Seedream 5 Pro sur Seedance API.
Seedance API expose Seedream 5 Pro derrière une surface REST stable — toutes les capacités du modèle avec auth, facturation et réponses normalisées, sans gérer vous-même les identifiants fournisseur.
Tableau image_urls vide pour le text-to-image. 1–10 URLs HTTPS publiques pour éditer ou composer des références — le même endpoint gère les deux.
1:1, 4:3, 3:4, 16:9, 9:16, 2:3 et 3:2. Choisissez le ratio adapté au placement — le modèle compose nativement, sans recadrage.
9 crédits par image 1K, 18 par 2K. L'édition par référence ajoute 0,8 crédit par image après la première. estimated_credits est visible avant le polling.
Environ 15–25 secondes en 1K ; plus long en 2K et multi-références. Pollez l'endpoint de statut — les tâches sont asynchrones par design.
Non — et il ne faut pas. Gardez votre clé Bearer côté backend, appelez nos endpoints côté serveur et n'exposez que vos propres routes sûres.
Oui — le texte multilingue dans l'image est l'un de ses points forts : posters, étiquettes et pubs localisées avec un texte lisible.
Le schéma de requête complet, les exemples de réponse, la table d'erreurs et les prix détaillés sont dans /docs/images. Cette page est l'aperçu d'intégration.
Obtenez une clé API, soumettez votre première tâche et branchez la génération d'images phare à votre produit dès aujourd'hui.