APIMart
APIMart

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.

Tutoriel

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 model sur seedream-5-0-pro
  • J'inclus prompt, ainsi que resolution (1K, 1.5K ou 2K) et size (auto ou un format comme 16: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 statut completed
  • 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.

APIMart
Seedream 5.0 Pro API : aide-mémoire requête et interrogation

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émentCe que j'en faisLimite ou remarque clé
Texte vers imageNouvelles images à partir du seul promptAucune image d'entrée
Édition à une référenceChanger le fond, la lumière ou des détails d'une imageUn élément dans image_urls
Édition multi-référencesCombiner personnes, tenues ou scènesJusqu'à 10 images de référence
Décomposition en calquesDécouper une affiche en calques modifiablesExactement une image d'entrée, jusqu'à 16 calques PNG
Fond transparentModifier un calque en gardant l'alphaUne 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

APIMart

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êteValeur
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/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

APIMart

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-pro est 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.5K ou 2K. 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 comme 2048x1024. 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 facultatifTypeQuand l'utiliser
image_urlsArrayÉdition et composition multi-références ; jusqu'à 10 URL publiques ou Data URI Base64
output_formatStringjpeg (par défaut) ou png
backgroundStringtransparent pour garder l'alpha en modifiant une image qui a déjà un canal alpha (nécessite png)
layer_decompositionBooleanDécouper une image en une image de base et jusqu'à 16 calques PNG transparents
optimize_prompt_optionsObjectOptimisation du prompt ; seul {"mode": "standard"} est pris en charge
watermarkBooleanAjouter la mention « générée par IA » en bas à droite
nsfw_checkBooleanModé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 :

  • n supérieur à 1, ou sequential_image_generation (utilisez Seedream 5.0 Lite pour les images en groupe)
  • stream ou tools (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 3K ou 4K, 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 comme 3:4. Passez en 2K uniquement 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_urls et désignez-les par leur ordre dans le prompt (« image 1 », « image 2 »). Avec size: "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: true pour 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 avec background: "transparent" et output_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.

Tags#Seedream 5.0 Pro#génération d'images#tutoriel API#développeurs

À 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.

Prêt à essayer ?

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.

Modèles chatModèles imageModèles vidéo
Explorer le marketplace