ByteDance

Seedream 5.5

seedream-5.5

Modèle de génération et de retouche d’images de l’équipe Seed de ByteDance, il prend en charge la génération d’images à partir de texte et la retouche à partir d’images de référence, avec jusqu’à 10 images de référence en entrée ; il peut produire des PNG à fond transparent et propose trois paliers de taille : 1K, 1,5K et 2K.

seedream-5.5

Essayer seedream-5.5

Entrée

Créations

Voir toutes les créations

Sortie

image

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

Kling 4.0 Flash et Seedream 5.5 disponibles, -20 % pour une durée limitée 20% OFF · Se termine le 2026-11-18 Voir l'offre

seedream-5.5 per image

Spécifications	Prix unitaire
1K	~~$0.0186~~ $0.01488 + ~~$0.0075~~ $0.006 Per Reference Image
1.5K	~~$0.0186~~ $0.01488 + ~~$0.0075~~ $0.006 Per Reference Image
2K	~~$0.0325~~ $0.026 + ~~$0.0075~~ $0.006 Per Reference Image

Présentation

Il s'agit d'un modèle de génération et d'édition d'images, capable de produire des images à partir de texte seul, ou de modifier ou conserver le contenu visuel d'une image en s'appuyant sur des images de référence. La sortie est une image statique, avec des paliers de pixels de 1K, 1,5K ou 2K, un rapport d'image, ainsi qu'un format PNG ou JPEG ; en choisissant un fond transparent, le format de sortie est limité au PNG. Il convient aux équipes e-commerce, au design publicitaire, à la production de supports localisés et aux créateurs ayant besoin d'ajuster les images de façon répétée, pour produire rapidement des visuels produits, des affiches et des images de style photoréaliste.

Points forts

Génération texte-image et édition d'image réunies — un même prompt permet de générer une nouvelle image ou, avec une image de référence, de modifier ou de conserver une image existante.
Sortie native à fond transparent — en choisissant un fond transparent et une sortie PNG, on obtient directement une image comportant des zones transparentes, ce qui réduit l'étape de détourage ultérieure.
Génération à partir de plusieurs images de référence — il est possible de fournir de 1 à 10 images de référence http(s) publiques en une fois, chacune facturée séparément, pour guider la génération ou l'édition de l'image.
Rapport d'image et netteté au choix — la sortie peut spécifier l'un des dix rapports d'image et choisir l'un des trois paliers de pixels : 1K, 1,5K ou 2K.

Description des capacités

Génération d'image à partir de texte : il suffit de saisir un prompt pour générer une image, le prompt pouvant contenir jusqu'à 5000 caractères ; le rapport d'image, le palier de pixels et le format de sortie peuvent être précisés en même temps ; s'ils sont omis, la sortie se fait en 2K et PNG.

Édition à partir d'images de référence : fournir de 1 à 10 images de référence http(s) publiques et préciser avec le prompt les éléments à modifier et à conserver, pour des retouches comme le remplacement d'objets ou l'ajustement de détails.

Contrôle du fond transparent : le fond peut être automatique, transparent ou opaque ; en choisissant un fond transparent, le format de sortie doit être PNG, ce qui convient aux scénarios nécessitant des visuels à fond transparent.

Configuration des spécifications de sortie : le palier de pixels de sortie est choisi parmi 1K, 1,5K et 2K, le rapport d'image parmi dix options, et le format parmi PNG ou JPEG ; si le rapport est omis, le modèle le choisit automatiquement selon le prompt et les images de référence.

Cas d'usage

Création de visuels produits à fond transparent pour l'e-commerce — à partir d'une image de référence du produit et d'un prompt ajustant le fond et les détails, produire un PNG à fond transparent pour les pages de détail produit et les supports publicitaires.
Génération en série d'affiches d'événement par les designers — décrire la mise en page et l'image par du texte, choisir un format vertical ou horizontal et le palier 2K, et produire l'image de fond de l'affiche pour une mise en page ultérieure.
Remplacement d'éléments visuels par les équipes publicitaires — téléverser une publicité existante et préciser les objets ou scènes à remplacer, générer l'image modifiée pour comparer plusieurs versions d'un même visuel.
Retouche continue par les créateurs de contenu — téléverser un portrait ou une image de produit, ajuster les vêtements, la lumière et les détails au fil de plusieurs prompts, et produire une image de style photoréaliste pour les réseaux sociaux.

Limites et conseils de choix

Les paliers de pixels de sortie se limitent à 1K, 1,5K et 2K, le palier 2K étant celui facturé par défaut. Le fond transparent n'est disponible qu'avec un format de sortie PNG ; en choisissant JPEG, les zones transparentes ne peuvent pas être conservées. Les images de référence doivent être des adresses http(s) accessibles publiquement, au nombre de 1 à 10, et chacune est facturée séparément. Le prompt peut contenir jusqu'à 5000 caractères. La séparation en calques et la sortie en 4K ne sont pas encore disponibles via cette interface et ne doivent pas être considérées comme des spécifications actuellement utilisables.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Nouveau modèle disponible : Seedream 5.5 Nov 11, 2026

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : seedream-5.5

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour seedream-5.5 et la route default — voir le tableau des paramètres ci-dessous.

sizestringOptionnelDéfaut: "2K"

Contrôle le niveau de pixels de l'image de sortie, prend une valeur d'énumération de chaîne ; par défaut 2K (en cas d'omission, la facturation se fait sur la base de 2K), 1K et 1.5K sont au même prix.

Options：1K1.5K2K

promptstringRequisminLength 1maxLength 5000

Décrit l'image à générer, ou, en combinant avec des images de référence, précise le contenu à modifier et à conserver ; c'est l'entrée d'instruction principale pour la génération et l'édition d'images.

backgroundstringOptionnelDéfaut: "auto"

Contrôle le mode d'arrière-plan du résultat généré, prend une valeur d'énumération de chaîne ; par défaut auto. Lorsqu'il est défini sur arrière-plan transparent, le format de sortie doit être PNG.

Options：autotransparentopaque

image_urlsarrayOptionnelminItems 1maxItems 10

Tableau d'images de référence, fournit 1 à 10 URL d'images publiques http(s) ; en cas d'omission, l'image est générée uniquement à partir de l'invite textuelle. Chaque image de référence est facturée séparément, ses éléments étant des chaînes de liens d'images.

Array [ string ]

aspect_ratiostringOptionnel

Contrôle le rapport de cadre de l'image de sortie, prend une valeur d'énumération de chaîne ; en cas d'omission, le modèle le choisit automatiquement en fonction de l'invite et des images de référence.

Options：1:14:33:416:99:163:22:321:9

Tout afficher (2)Afficher moins

2:11:2

output_formatstringOptionnelDéfaut: "png"

Contrôle le format de l'image de sortie, prend une valeur d'énumération de chaîne ; par défaut png. Lorsque background est transparent, seul png est pris en charge.

Options：pngjpeg

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
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": {
    "size": "2K",
    "prompt": "…",
    "background": "auto",
    "output_format": "png"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedream-5.5",
    input: {
      "size": "2K",
      "prompt": "…",
      "background": "auto",
      "output_format": "png"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedream-5.5",
        "input": {
          "size": "2K",
          "prompt": "…",
          "background": "auto",
          "output_format": "png"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}