Guide de l'API Seedream 5.5 : tarifs, paramètres et exemples d'appel

Ce que Seedream 5.5 peut faire

Seedream 5.5 est un modèle d'image disponible sur HiAPI. Un seul ID de modèle (seedream-5.5) couvre deux usages : en saisissant uniquement une invite, il génère une image à partir de texte ; en ajoutant des images de référence, il édite l'image ou conserve le contenu visuel en fonction de ces références. Les deux usages passent par la même interface et le même jeu de paramètres ; la seule différence réside dans la présence ou non de image_urls dans la requête.

Chaque appel renvoie une image. Voici l'explication dans l'ordre « comment le prix est calculé → comment remplir les paramètres → comment envoyer la requête → quelles sont les limites » ; tous les chiffres sont conformes à la définition de l'interface au moment de la rédaction de cet article.

Tarification : facturation par palier de pixels, supplément par image de référence

Le coût se compose de deux parties : le prix de base du palier de sortie, plus les frais d'images de référence.

• 1K / 1.5K : 0,0186 $ / image
• 2K (palier par défaut) : 0,0325 $ / image
• Image de référence : 0,0075 $ par image, la première est également facturée, jusqu'à 10 images

Quelques exemples :

• Génération d'image à partir de texte en 1K, sans image de référence : 0,0186 $
• 2K, avec 1 image de référence : 0,0325 $ + 0,0075 $ = 0,04 $
• 2K, avec 10 images de référence (maximum) : 0,0325 $ + 0,075 $ = 0,1075 $

Si size n'est pas renseigné, l'image est générée en 2K et facturée en 2K. Pour de simples esquisses ou des illustrations de petite taille, indiquer explicitement "size": "1K" permet d'économiser environ 40 %. En cas d'échec de la tâche, les frais sont intégralement remboursés.

Aperçu des paramètres

À l'exception de model et prompt, tous les paramètres sont facultatifs :

• prompt : obligatoire, de 1 à 5000 caractères. Décrit l'image à générer ; avec des images de référence, précisez clairement ce qu'il faut modifier et ce qu'il faut conserver.
• size : 1K, 1.5K, 2K, valeur par défaut 2K.
• aspect_ratio : 10 options possibles — 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 2:1, 1:2. S'il n'est pas renseigné, le modèle le choisit automatiquement en fonction de l'invite et des images de référence.
• image_urls : de 1 à 10 adresses d'images http(s) accessibles publiquement. Sans ce paramètre, il s'agit d'une génération purement textuelle.
• output_format : png ou jpeg, valeur par défaut png.
• background : auto, transparent, opaque, valeur par défaut auto. Avec transparent, le format de sortie ne peut être que png ; associé à jpeg, la requête sera rejetée.

Envoyer une requête

Les tâches d'image de HiAPI sont asynchrones : créez d'abord la tâche, puis interrogez le résultat. model se place au niveau supérieur, les autres paramètres vont dans input.

Génération d'image à partir de texte (2K, 16:9) :

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "input": {
      "prompt": "清晨的海边灯塔，薄雾，柔和的侧光，写实摄影风格",
      "size": "2K",
      "aspect_ratio": "16:9"
    }
  }'

Édition par image de référence (1K, fond transparent, PNG) :

{
  "model": "seedream-5.5",
  "input": {
    "prompt": "保留瓶身和标签，去掉背景，换成柔和的顶光",
    "image_urls": ["https://example.com/bottle.jpg"],
    "size": "1K",
    "background": "transparent",
    "output_format": "png"
  }
}

Le coût de cette requête est de 0,0186 $ + 0,0075 $ = 0,0261 $. Une fois la création réussie, utilisez l'ID de tâche renvoyé pour appeler GET https://api.hiapi.ai/v1/tasks/{taskId} en boucle ; lorsque le statut passe à « réussi », récupérez l'adresse de l'image dans la sortie pour la télécharger.

Limites actuelles

• Maximum 2K, pas de palier 4K.
• Pas de prise en charge de la sortie par calques d'image.
• Chaque appel ne produit qu'une seule image ; pour en obtenir plusieurs, lancez plusieurs tâches en parallèle.
• Les images de référence doivent être des adresses http(s) accessibles depuis l'internet public ; les chemins de fichiers locaux ou le base64 ne sont pas acceptés.
• Le fond transparent n'est pris en charge qu'en PNG.

Comment choisir le palier

Pour les affiches et les images principales de produits destinées à une mise en ligne directe, utilisez le 2K par défaut ; pour les maquettes de révision interne, les essais de style en lot et les vignettes de petite taille, utilisez 1K ou 1.5K (les deux sont au même prix ; le 1.5K étant plus net, il n'y a aucune raison de choisir le 1K alors que le 1.5K est disponible). Les images de référence étant facturées à l'unité, ne conservez que celles qui influencent réellement le résultat ; pour les images multi-angles d'un même produit, commencez par en essayer 1 ou 2, puis ajoutez-en si le résultat n'est pas suffisant.