Guide API Seedream 5 Pro

API Seedream 5 Pro pour la génération d'images IA

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.

Résolution
1K / 2K

Sortie 1K ou 2K

Ratios
7

1:1 à 16:9, 9:16, 2:3, 3:2

Entrées
T2I + I2I

Prompt ou jusqu'à 10 images de référence

Interface
REST

JSON sur HTTPS

Requête de démarrage

Créer une tâche image Seedream 5 Pro

seedream-5-pro
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.

Pourquoi intégrer l'API Seedream 5 Pro

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.

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.

Un alias de modèle stable

Vous appelez model "seedream-5-pro". Routage, capacité et fallbacks restent de notre côté — votre intégration ne subit pas les changements amont.

Tarification prévisible en crédits

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.

Capacités de l'API Seedream 5 Pro

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.

Génération text-to-image

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.

Édition multi-références

Passez 1–10 URLs HTTPS publiques dans image_urls pour éditer, composer ou restyler des visuels existants — remplacement produit, fond, transfert de style.

Sortie haute résolution 2K

Mettez resolution à "2k" pour des rendus qualité print et des assets finaux. 1K suffit pour previews et itérations.

Texte multilingue dans l'image

L'un des points forts du modèle — texte lisible en anglais, chinois, japonais et plus sur posters et enseignes.

Architecture de jobs asynchrones

La création renvoie immédiatement un task_id. Pollez le statut à votre rythme et gardez l'UI réactive — pas de connexions longues.

Réponses indépendantes du fournisseur

Le format de réponse reste stable quel que soit le routage amont — consumed_credits, status et URLs d'images sont normalisés.

Comment appeler l'API Seedream 5 Pro

Trois étapes de la clé API à l'URL d'image finale.

1

Créer une clé API

Connectez-vous, ouvrez la page API Keys et copiez une clé pour usage serveur. Gardez-la côté backend — jamais dans le code navigateur.

2

Soumettre une tâche de génération

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.

3

Poller et afficher

Appelez GET /v1/images/generations/:task_id. Quand status atteint SUCCESS, lisez images[0].url et affichez ou archivez le résultat.

Référence des endpoints

Deux endpoints couvrent tout le cycle — création et polling.

POST /v1/images/generations

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.

GET /v1/images/generations/:task_id

Renvoie IN_PROGRESS, SUCCESS avec images[].url ou FAILED avec un objet erreur. Indique aussi consumed_credits une fois terminé.

Erreurs et limites

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ètres de requête

ParamètreValeur
modelDoit être "seedream-5-pro" — le seul modèle public sur cette route.
promptPrompt texte ou instruction d'édition, 1–3000 caractères.
aspect_ratioUn 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_urls0–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.

Tarification en crédits

Prix fixe par image en crédits Seedance API. La réponse de création inclut estimated_credits ; le statut final indique consumed_credits.

ModeCréditsNotes
Text-to-image · 1K9 crédits / imageRésolution par défaut — pour itérations et previews.
Text-to-image · 2K18 crédits / imageQualité print pour les assets finaux.
Édition par référence+0,8 crédit / image en plusPremière référence incluse ; les images 2–10 ajoutent 0,8 chacune.

FAQ API Seedream 5 Pro

Réponses pour les développeurs qui évaluent l'API Seedream 5 Pro sur Seedance API.

Est-ce l'API officielle ByteDance Seedream 5 Pro ?

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.

Quelle différence entre text-to-image et édition par référence ?

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.

Quels ratios l'API Seedream 5 Pro supporte-t-elle ?

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.

Combien coûte une image Seedream 5 Pro ?

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.

Combien de temps prend une génération ?

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.

Puis-je appeler cette API depuis le navigateur ?

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.

Seedream 5 Pro rend-il du texte dans les images ?

Oui — le texte multilingue dans l'image est l'un de ses points forts : posters, étiquettes et pubs localisées avec un texte lisible.

Où est la documentation API complète ?

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.

Créez votre première image Seedream 5 Pro

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.