

Comment générer des images avec Seedream 5.0 Pro
Guide étape par étape pour appeler Seedream 5.0 Pro sur APIMart : authentification, champs de requête, interrogation des tâches, lecture des résultats et sauvegarde des images avant l'expiration des liens.
Vous pouvez faire tourner Seedream 5.0 Pro avec une requête POST, une clé API et une étape de suivi : vous envoyez la tâche, récupérez un task_id, puis interrogez la tâche jusqu'à ce que l'image soit prête. Seedream 5.0 Pro est asynchrone : la première réponse ne contient jamais l'image.
La version courte :
- J'envoie les requêtes à
https://api.apimart.ai/v1/images/generations - J'ajoute
Authorization: Bearer YOUR_API_KEY - Je règle
modelsurseedream-5-0-pro - J'inclus
prompt, ainsi queresolution(1K,1.5Kou2K) etsize(autoou un format comme16:9) - Pour modifier ou combiner des images, j'ajoute jusqu'à 10 images de référence dans
image_urls - J'interroge
GET /v1/tasks/{task_id}toutes les 5 à 10 secondes jusqu'au statutcompleted - Je télécharge le résultat aussitôt, car les liens d'image sont valables 72 heures
L'essentiel à retenir : c'est un modèle à image unique. Chaque requête renvoie une image, et un n supérieur à 1 est refusé. Vous pouvez tester la Seedream 5.0 Pro API sur APIMart ; la liste complète des champs se trouve dans la référence de l'API.

Points clés
- Seedream 5.0 Pro s'appelle avec une requête POST vers
https://api.apimart.ai/v1/images/generations, l'en-tête Authorization: Bearer YOUR_API_KEY et model égal à seedream-5-0-pro. - Le palier de sortie se choisit avec resolution (1K, 1.5K ou 2K) et la forme avec size : auto, l'un des dix formats ou des pixels exacts. 1.5K coûte le même prix que 1K ; 3K et 4K renvoient 400.
- Chaque requête produit une image. n supérieur à 1, la génération en groupe, le streaming et la recherche web sont refusés avec 400, et aucune tâche n'est créée.
- L'édition d'image envoie jusqu'à 10 images de référence via image_urls, sous forme d'URL publiques ou de Data URI Base64.
- La première réponse ne contient qu'un task_id. Interrogez l'endpoint des tâches toutes les 5 à 10 secondes, puis enregistrez l'image dans les 72 heures.
Comparaison rapide
| Élément | Ce que j'en fais | Limite ou remarque clé |
|---|---|---|
| Texte vers image | Nouvelles images à partir du seul prompt | Aucune image d'entrée |
| Édition à une référence | Changer le fond, la lumière ou des détails d'une image | Un élément dans image_urls |
| Édition multi-références | Combiner personnes, tenues ou scènes | Jusqu'à 10 images de référence |
| Décomposition en calques | Découper une affiche en calques modifiables | Exactement une image d'entrée, jusqu'à 16 calques PNG |
| Fond transparent | Modifier un calque en gardant l'alpha | Une image d'entrée avec alpha, output_format: "png" |
En bref : ce guide montre comment je configure l'authentification, construis le corps de la requête, interroge la tâche et enregistre le résultat sans perdre de fichiers.
1. Configurer l'accès à l'API et l'authentification
1.1 Créer votre compte APIMart et générer une clé API

Inscrivez-vous sur APIMart, ouvrez la page de gestion des clés API dans votre tableau de bord et créez une clé. Copiez-la immédiatement et stockez-la côté serveur, dans un gestionnaire de secrets ou une variable d'environnement.
Ne placez jamais la clé dans du code frontend ou un dépôt public : quiconque la possède peut dépenser votre solde. En Node.js, lisez-la depuis process.env.APIMART_API_KEY ; dans un terminal, utilisez export APIMART_API_KEY="your-key-here".
1.2 Définir l'URL de base et l'en-tête d'authentification Bearer
Chaque requête part vers l'URL de base https://api.apimart.ai avec deux en-têtes :
| En-tête | Valeur |
|---|---|
Authorization | Bearer YOUR_API_KEY |
Content-Type | application/json |
Gardez le préfixe Bearer avec exactement un espace. Un jeton absent ou mal formé renvoie 401. Si cURL fonctionne mais pas votre application, le problème vient généralement de la façon dont l'application construit les en-têtes.
2. Construire une requête d'image Seedream 5.0 Pro

2.1 Champs principaux : Model, Prompt, Resolution et Size
Une requête texte vers image nécessite model et prompt. Deux autres champs contrôlent la sortie :
model:seedream-5-0-pro(seedream-5.0-proest aussi accepté).prompt: une description en langage naturel. En plus du chinois et de l'anglais, le modèle affiche nativement du texte en français, japonais, coréen, espagnol, portugais, allemand, russe, indonésien, vietnamien et dans d'autres langues. Restez autour de 600 mots anglais ; les prompts très longs peuvent perdre des détails.resolution:1K(par défaut),1.5Kou2K. 1.5K coûte le même prix que 1K, c'est donc généralement le meilleur choix.size:auto(par défaut), l'un des dix formats (1:1,4:3,3:4,16:9,9:16,3:2,2:3,2:1,1:2,21:9) ou des pixels exacts comme2048x1024. Les pixels exacts doivent totaliser entre 921 600 et 4 624 220, avec un rapport entre 1:16 et 16:1.
Par exemple, resolution: "1.5K" avec size: "16:9" renvoie une image de 2048×1152.
2.2 Champs facultatifs
| Paramètre facultatif | Type | Quand l'utiliser |
|---|---|---|
image_urls | Array | Édition et composition multi-références ; jusqu'à 10 URL publiques ou Data URI Base64 |
output_format | String | jpeg (par défaut) ou png |
background | String | transparent pour garder l'alpha en modifiant une image qui a déjà un canal alpha (nécessite png) |
layer_decomposition | Boolean | Découper une image en une image de base et jusqu'à 16 calques PNG transparents |
optimize_prompt_options | Object | Optimisation du prompt ; seul {"mode": "standard"} est pris en charge |
watermark | Boolean | Ajouter la mention « générée par IA » en bas à droite |
nsfw_check | Boolean | Modérer le prompt et les images d'entrée avant l'envoi de la tâche |
Chaque image de référence peut être en jpeg, png, webp, bmp, tiff, gif, heic ou heif, jusqu'à 30 Mo et 36 millions de pixels. La première référence est gratuite ; chaque référence supplémentaire ajoute un supplément fixe.
Pour cibler une modification avec précision, indiquez des coordonnées dans le prompt : <point>x y</point> pour un point ou <bbox>x1 y1 x2 y2</bbox> pour une zone.
2.3 Champs refusés par ce modèle
Seedream 5.0 Pro est un modèle à image unique. Ces requêtes renvoient 400, ne créent aucune tâche et ne sont pas facturées :
nsupérieur à 1, ousequential_image_generation(utilisez Seedream 5.0 Lite pour les images en groupe)streamoutools(le streaming et la recherche web ne sont pas pris en charge)- plus de 10 éléments dans
image_urls - des paliers non pris en charge comme
3Kou4K, ou des formats absents de la liste ci-dessus
2.4 Exemples d'appels en cURL et JavaScript
Voici une requête cURL minimale pour une image 16:9 au palier 1.5K :
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header "Authorization: Bearer $APIMART_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedream-5-0-pro",
"prompt": "A sunlit mountain trail in autumn, photorealistic, wide angle",
"resolution": "1.5K",
"size": "16:9"
}'
La réponse confirme seulement la tâche :
{
"code": 200,
"data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}
Et voici une édition multi-références en Node.js avec fetch :
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APIMART_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedream-5-0-pro",
prompt: "Replace the outfit in image 1 with the outfit in image 2",
image_urls: ["https://example.com/person.jpg", "https://example.com/dress.jpg"],
resolution: "2K",
size: "auto",
}),
});
const { data } = await response.json();
const taskId = data[0].task_id;
Gardez ces appels côté serveur, jamais dans le code client.
3. Interroger la tâche et enregistrer l'image
3.1 Vérifier le statut de la tâche
Envoyez GET https://api.apimart.ai/v1/tasks/{task_id} avec le même en-tête Authorization. Seedream 5.0 Pro privilégie la qualité, une tâche peut donc prendre quelques minutes. Interrogez toutes les 5 à 10 secondes et fixez le délai d'expiration du client à environ 5 minutes.
Arrêtez d'interroger quand status vaut completed ou failed. Les tâches échouées sont intégralement remboursées.
3.2 Lire le résultat
Une tâche terminée ressemble à ceci :
{
"code": 200,
"data": {
"id": "task_01JFXYZ123456789ABCDEF",
"status": "completed",
"progress": 100,
"result": {
"images": [
{
"url": ["https://cdn.example.com/images/image_task_xxx_0.png"],
"expires_at": 1784696685
}
]
}
}
}
Lisez l'image dans data.result.images[0].url[0]. La réponse inclut aussi le cost de la tâche. Les liens sont valables 72 heures (expires_at est un horodatage Unix) : téléchargez le fichier et placez-le dans votre propre stockage au lieu d'enregistrer l'URL.
3.3 Exemple complet en Python
import os
import time
import requests
BASE_URL = "https://api.apimart.ai"
headers = {
"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}",
"Content-Type": "application/json",
}
created = requests.post(
f"{BASE_URL}/v1/images/generations",
headers=headers,
json={
"model": "seedream-5-0-pro",
"prompt": "A product poster with the headline SUMMER SALE in bold letters",
"resolution": "1.5K",
"size": "3:4",
"output_format": "png",
},
timeout=30,
)
created.raise_for_status()
task_id = created.json()["data"][0]["task_id"]
while True:
task = requests.get(f"{BASE_URL}/v1/tasks/{task_id}", headers=headers, timeout=30).json()["data"]
if task["status"] == "completed":
image_url = task["result"]["images"][0]["url"][0]
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", task["status"]))
time.sleep(5)
with open("seedream-5-0-pro.png", "wb") as f:
f.write(requests.get(image_url, timeout=60).content)
4. Trois workflows d'image courants
-
Affiches et visuels avec texte. Mettez le texte exact entre guillemets dans le prompt, décrivez la mise en page (par exemple « affiche verticale, titre en haut ») et utilisez
resolution: "1.5K"avec un format fixe comme3:4. Passez en2Kuniquement pour les visuels finaux, car ce palier coûte plus cher. -
Édition multi-références. Placez les images de personne, de produit ou de scène dans
image_urlset désignez-les par leur ordre dans le prompt (« image 1 », « image 2 »). Avecsize: "auto", le format de sortie suit les références. Ajoutez des coordonnées<bbox>pour indiquer précisément où placer un élément. -
Décomposition en calques et retouches transparentes. Envoyez un PNG ou un JPEG avec
layer_decomposition: truepour obtenir une image de base et jusqu'à 16 calques PNG transparents avec leurs positions et leur ordre d'empilement. Pour modifier un calque, renvoyez-le avecbackground: "transparent"etoutput_format: "png". Les tâches de calques sont facturées par image produite après une préautorisation, et l'excédent est remboursé.
5. Checklist finale pour une intégration fiable de Seedream 5.0 Pro
Authentification et sécurité de la clé. Conservez la clé dans une variable d'environnement ou un gestionnaire de secrets et appelez l'API uniquement depuis votre backend.
Validez les paramètres avant l'envoi. Utilisez seedream-5-0-pro, omettez n (ou mettez 1), limitez image_urls à 10 et n'utilisez que 1K, 1.5K ou 2K avec une size prise en charge.
Prévoyez le flux asynchrone. Interrogez toutes les 5 à 10 secondes, fixez un délai client d'environ 5 minutes et gérez les tâches failed.
Traitez la livraison comme une question de stockage. Téléchargez chaque image dès que la tâche réussit ; les liens expirent au bout de 72 heures.
Vérifiez le coût avant de passer à l'échelle. La sortie est facturée par image selon le palier de pixels (1K et 1.5K partagent le prix le plus bas, 2K coûte plus cher), et chaque référence après la première ajoute un supplément. Consultez la grille tarifaire à jour avant les gros lots.
FAQ
Comment vérifier une tâche d'image après avoir reçu un task_id ?
Envoyez GET https://api.apimart.ai/v1/tasks/{task_id} avec votre en-tête Authorization: Bearer.
Interrogez toutes les 5 à 10 secondes jusqu'à ce que status vaille completed, puis lisez l'image dans data.result.images[0].url[0]. Si le statut est failed, consultez le champ error ; les tâches échouées sont remboursées.
Puis-je obtenir plusieurs images ou une sortie Base64 en une seule requête ?
Non. Seedream 5.0 Pro renvoie une image par requête, et un n supérieur à 1 est refusé avec 400. Pour plusieurs variantes, envoyez plusieurs requêtes ou utilisez Seedream 5.0 Lite pour la génération en groupe.
Le résultat est toujours une URL ; choisissez jpeg ou png avec output_format. Le Base64 est pris en charge pour les images d'entrée dans image_urls, pas pour la sortie.
Quelle est la meilleure façon de ne pas perdre les images générées ?
Les liens d'image sont valables 72 heures, et expires_at dans le résultat indique le moment exact.
Téléchargez chaque image dans votre propre stockage dès que la tâche passe à completed, et conservez vous-même le task_id. Ne considérez pas l'URL renvoyée comme un stockage permanent.
À propos de l'équipe APIMart
L'équipe APIMart rédige des guides de modèles, des comparatifs et des analyses de prix pour les développeurs qui construisent avec l'IA. APIMart propose une seule API pour les modèles de chat, d'image et de vidéo de plusieurs fournisseurs : vous pouvez comparer les modèles présentés ici avant la mise en production.
Choisissez le modèle qui vous convient dans le marketplace
Essayez les modèles de chat, image et vidéo sur le marketplace APIMart, puis découvrez rapidement leurs capacités avec une API unifiée.
