Comment obtenir une clé API Seedream en 2026 : étapes BytePlus, prix officiels et alternative à clé unique

Vous avez un prompt Seedream qui fonctionne dans une application web et vous voulez maintenant l’utiliser dans votre propre code. Il vous faut donc une clé API. Il y a deux façons d’en obtenir une : le cloud de ByteDance lui-même, BytePlus ModelArk, où vous créez une clé, choisissez un ID de modèle et payez à l’image ; ou une plateforme d’API qui exécute Seedream derrière une clé unique, avec d’autres modèles. Ce guide couvre les deux, avec les étapes exactes, les prix officiels au 12 octobre 2026 et ce qui change entre elles.

Réponse courte : connectez-vous à la console BytePlus, ouvrez la page API keys, cliquez sur Create API key, puis appelez https://ark.ap-southeast.bytepluses.com/api/v3/images/generations avec la clé comme jeton bearer et un ID de modèle tel que dola-seedream-5-0-pro-260628. Seedream 5.0 Pro coûte $0.045 par image jusqu’à 1.5K et $0.09 au-delà, Flash $0.018 et Lite $0.035. BytePlus applique un filtre de contenu par défaut. Une clé SpicyAPI exécute les mêmes versions de modèles Seedream sans filtre ajouté, à $0.036 par image 1K pour 5.0 Pro, et la même clé appelle aussi des modèles vidéo et d’autres modèles d’image.

• Un seul modèle, compte officiel : BytePlus ModelArk. La voie la moins chère vers Seedream 5.0 Flash.
• Plusieurs modèles, travail pour adultes, ou prix Pro plus bas : une clé de plateforme d’API comme SpicyAPI.
• Pages « clé API Seedream gratuite » : la grille de prix officielle n’a aucun quota de sortie gratuit. Les clés partagées en ligne sont le quota de quelqu’un d’autre.

Option 1 : obtenir une clé API Seedream auprès de BytePlus ModelArk

BytePlus est le cloud international de ByteDance, et ModelArk est son service de modèles. Seedream y figure parmi les modèles d’image, aux côtés de la vidéo Seedance et des modèles de langage Seed. Un seul compte et une seule clé couvrent tout cela.

1. Créez un compte BytePlus et connectez-vous à la console. Ajoutez un moyen de paiement avant d’en dépendre : selon la page de tarifs officielle, un compte qui reste en impayé pendant deux heures voit ses services de modèles suspendus jusqu’à ce qu’il soit réapprovisionné.
2. Ouvrez la page API keys. Si votre organisation utilise des espaces de projet, passez d’abord au bon espace en bas à gauche, car une clé n’atteint que les modèles de son propre projet.
3. Cliquez sur Create API key, confirmez le nom, puis cliquez sur Create. La clé apparaît dans la liste des clés API. Les clés créées après le 17 septembre 2026 utilisent un nouveau format en clair ; les anciennes clés fonctionnent toujours.
4. Placez la clé dans une variable d’environnement (la documentation utilise ARK_API_KEY) plutôt que dans votre code.

Les étapes officielles pour la clé s’arrêtent là. La console comporte aussi une page Model activation, qui affiche vos limites de débit ; plusieurs guides tiers ajoutent une étape d’activation avant le premier appel d’image, donc si un appel est rejeté pour un problème d’accès, cette page est le premier endroit où regarder.

Appelez ensuite l’endpoint d’image avec l’ID du modèle :

curl https://ark.ap-southeast.bytepluses.com/api/v3/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

L’appel est synchrone. La réponse contient un tableau data, et l’url de chaque élément est un lien de téléchargement pour une image. Le lien n’est conservé que 24 heures : téléchargez ou copiez donc le fichier vers votre propre stockage immédiatement. Réglez response_format sur b64_json si vous préférez recevoir les octets de l’image dans la réponse. watermark vaut true par défaut, ce qui ajoute une marque visible ; réglez-le sur false si vous n’en voulez pas.

Trois autres points valent la peine d’être connus avant de construire dessus :

• Restreignez chaque clé. Une clé peut être limitée à des ID de modèles précis et à des adresses IP précises. Un compte peut contenir jusqu’à 50 clés, donc une clé distincte et restreinte par application est une assurance bon marché contre une fuite.
• Surveillez la limite de débit. Seedream 5.0 Pro et Flash autorisent 500 images par minute et par version de modèle sur un compte ; au-delà, les appels renvoient une erreur.
• La modération de contenu est activée par défaut. Le pré-filtre de contenu de ModelArk couvre les contenus pour adultes et explicites et est activé sur les nouveaux endpoints ; vous pouvez le désactiver endpoint par endpoint, mais un socle de politiques de contenu de BytePlus continue de s’appliquer. Les images bloquées ne sont pas facturées.

ID des modèles Seedream sur BytePlus

BytePlus appelle désormais les modèles 5.0 Pro et Flash « Dola Seedream ». C’est la même gamme de modèles. Le suffixe de date change à chaque nouveau snapshot ; copiez donc l’ID depuis la liste des modèles plutôt que de le deviner.

Prix officiels de l’API Seedream

D’après la page de tarifs ModelArk, consultée le 12 octobre 2026 :

La grille n’a aucun quota de sortie gratuit. Un lot de 1 000 images Seedream 5.0 Pro en 2K coûte $90, et 1 000 images Flash coûtent $18.

Option 2 : utiliser Seedream avec une seule clé SpicyAPI

Une plateforme d’API vous donne une seule clé pour de nombreux modèles et gère les comptes fournisseurs en coulisses. Sur SpicyAPI, les étapes sont les suivantes :

1. Inscrivez-vous et ouvrez les clés API dans la console.
2. Créez une clé. Vous pouvez la plafonner par jour, par mois et sur toute sa durée de vie, et restreindre les modèles qu’elle peut appeler.
3. Ajoutez du solde par carte, Apple Pay, Google Pay ou crypto. C’est un solde en dollars américains, sans abonnement, et le solde payé n’expire pas.
4. Appelez l’endpoint de tâche avec le nom du modèle :

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data '{
    "model": "bytedance/seedream-5.0-pro/text-to-image",
    "input": {
      "prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
      "resolution": "2k",
      "aspect_ratio": "16:9"
    }
  }'

Cet appel est asynchrone : il renvoie immédiatement un ID de tâche. Interrogez GET https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=<id> jusqu’à la fin de la tâche, ou transmettez une URL de rappel à la création. Les images terminées sont stockées sur le stockage propre de SpicyAPI et conservées jusqu’à 14 jours, derrière des liens signés : vous ne courez donc pas contre une expiration à 24 heures. La référence de l’API détaille les champs, et la page Seedream 5.0 Pro donne le schéma d’entrée complet, y compris les retouches avec images de référence et la décomposition en calques.

Prix par image au 12 octobre 2026 :

Pro est 20 % moins cher que le prix officiel dans les deux tailles ; SpicyAPI propose 1K et 2K, pas 1.5K. Lite et 4.0 coûtent à peu près la même chose. Flash coûte plus cher sur SpicyAPI que sur BytePlus. Si Flash est tout ce dont vous avez besoin et que votre contenu respecte les politiques de BytePlus, la clé officielle est le choix le moins cher.

La différence la plus importante est ce qui revient. SpicyAPI n’ajoute aucun filtre de contenu à Seedream. Lors de nos tests de septembre, Seedream 5.0 Pro a respecté 33 des 34 essais pour adultes en texte vers image et en retouche, Lite les a tous respectés (34 sur 34), et Flash a atténué quelques-unes des demandes plus fortes. Les résultats complets sont dans Seedream est-il non censuré ?. Le modèle décide toujours de ce qu’il dessine, et les personnages adultes ainsi que les droits sur toute photo que vous retouchez restent de votre responsabilité.

Quelle clé choisir ?

Vous pouvez aussi utiliser les deux : BytePlus pour le travail généraliste où il est le moins cher, et une clé de plateforme pour tout le reste.

Et pour une « clé API Seedream gratuite » ?

« Seedream API key free » et « Seedream API key generator » sont des recherches courantes. Il n’existe pas de clé gratuite officielle. BytePlus facture chaque image en sortie, et les images d’entrée sont gratuites. Les clés publiées sur GitHub ou dans des forums appartiennent au compte de quelqu’un d’autre. Elles cessent de fonctionner dès que leur propriétaire s’en aperçoit, et tout ce que vous construisez dessus s’arrête avec elles. Les sites « générateurs » qui promettent une clé gratuite revendent un accès ou distribuent des clés qui ne sont pas les leurs.

La façon honnête la moins chère de tester est d’envoyer une poignée d’images : dix images Seedream 5.0 Pro en 1K coûtent moins de 50 cents sur l’une ou l’autre voie. Sur SpicyAPI, les tâches en échec ne sont généralement pas facturées (chaque page de modèle indique si un modèle fait exception), et le prix d’un essai est affiché avant que vous ne le lanciez.

Dépanner une nouvelle clé

• 401 ou « invalid API key » : vérifiez que l’en-tête est Authorization: Bearer <key> et qu’il n’y a ni espace ni saut de ligne final dans votre variable d’environnement.
• Erreurs d’accès ou « model not found » sur BytePlus : l’ID du modèle est mal orthographié, la clé est restreinte à d’autres modèles, ou elle appartient à un autre espace de projet. Si rien de cela ne s’applique, consultez la page Model activation.
• Erreurs de contenu sur BytePlus : le pré-filtre a bloqué le prompt ou la sortie. Elles ne sont pas facturées. Reformuler peut aider pour un contenu généraliste à la limite. Pour le travail pour adultes, lisez d’abord la politique d’usage de BytePlus, car ses règles de contenu de base s’appliquent à tout le compte même avec le filtre désactivé.
• Les liens cessent de fonctionner le lendemain : les URL d’images BytePlus expirent au bout de 24 heures. Enregistrez le fichier dès que la réponse arrive.
• Les appels s’arrêtent après plusieurs jours de bon fonctionnement : vérifiez le solde du compte. Un compte en impayé pendant deux heures est suspendu jusqu’à ce qu’il soit réapprovisionné.

Questions fréquentes

Où trouver ma clé API Seedream ?

Dans la console BytePlus, sur la page API keys. Sur SpicyAPI, sous Console → API keys. Dans les deux cas, la liste des clés affiche celles que vous avez créées.

L’API Seedream est-elle gratuite ?

Non. Sur BytePlus, chaque image en sortie est facturée, de $0.018 pour 5.0 Flash à $0.09 pour 5.0 Pro au-delà de 1.5K. Les images d’entrée sont gratuites, sauf que Seedream 5.0 Pro facture $0.003 pour chaque image d’entrée après la première.

Quel est l’ID de modèle de Seedream 5.0 ?

Sur BytePlus, dola-seedream-5-0-pro-260628 pour Pro, dola-seedream-5-0-flash-260915 pour Flash et seedream-5-0-lite-260128 pour Lite. Sur SpicyAPI, bytedance/seedream-5.0-pro/text-to-image et les noms correspondants pour Flash, Lite et les retouches.

Puis-je utiliser l’API Seedream pour des images NSFW ?

Pas avec les réglages BytePlus par défaut : le pré-filtre de contenu bloque les contenus pour adultes, et les politiques de contenu de BytePlus s’appliquent même lorsqu’il est désactivé. Sur SpicyAPI, aucun filtre n’est ajouté, et Seedream 5.0 Pro et Lite ont respecté presque tous nos tests pour adultes.

Seedream 4.5 ou 5.0 ?

Sur BytePlus, 5.0 Lite ($0.035) coûte moins cher que 4.5 ($0.04), et 5.0 Flash ($0.018) moins cher que les deux. Pro est celui pour lequel il vaut la peine de payer plus, quand la qualité d’image compte le plus. Notre comparatif Lite, Pro et Flash présente les résultats côte à côte.

En résumé

Obtenir une clé API Seedream auprès de BytePlus ne prend que quelques minutes : créez une clé, utilisez le bon ID de modèle, enregistrez chaque image dans les 24 heures et gardez un œil sur le solde. C’est la voie la moins chère vers Seedream 5.0 Flash et la bonne pour le travail généraliste sur un compte direct chez ByteDance. Si vous voulez Seedream à côté d’autres modèles d’image et de vidéo sous une seule clé, un prix Pro plus bas, des résultats disponibles jusqu’à deux semaines, ou des images pour adultes sans filtre de fournisseur, une clé SpicyAPI répond à ces besoins.

Créer une clé SpicyAPI et essayer Seedream 5.0 Pro →