ByteDance

Seedream 4.5

seedream-4.5/text-to-image

Modèle d'image commercial de ByteDance, axé sur un éclairage et une ambiance cinématographiques, la cohérence des personnages entre les prises de vue et l'édition par référence multi-images, adapté à la production d'images haute résolution pour le commerce en ligne et les supports marketing

seedream-4.5/image-to-image seedream-4.5/text-to-image

Essayer seedream-4.5/text-to-image

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

seedream-4.5/text-to-image per image

Prix unitaire	$0.045

Positionnement

La ligne text-to-image Seedream 4.5 s'adresse aux développeurs qui ont besoin de productions visuelles contrôlables et réutilisables, en générant directement des images de style photoréaliste à partir de prompts textuels. Elle prend en charge deux résolutions natives, 2K et 4K, ainsi que huit formats d'image, du 1:1 au 21:9, avec une limite de 3000 caractères par prompt. Elle convient aux tâches de génération d'images en lot exigeant une qualité et une composition précises, telles que les visuels produits e-commerce, les supports marketing, les concepts audiovisuels et les maquettes de design ; il suffit de l'appeler via l'interface unifiée de HiAPI.ai pour l'intégrer aux flux de génération existants.

Points clés

Sortie native haute résolution 2K/4K — la sortie peut être en 2K standard ou en 4K ultra HD, ce qui évite l'étape d'agrandissement après une génération en basse résolution.
Huit formats d'image couvrant les principaux emplacements — du carré 1:1 au format large 21:9, tous directement spécifiables, pour s'adapter aux différents formats e-commerce, réseaux sociaux et bannières.
Éclairage cinématographique et rendu photoréaliste — des études indiquent que sa simulation de l'éclairage reproduit le brouillard volumétrique et les ombres complexes de la photographie réelle, pour un rendu final plus proche d'une prise de vue réelle.
Des prompts longs pour des descriptions complexes — la limite de 3000 caractères permet de détailler scène, matières et relations spatiales en une seule requête.

Description des capacités

Génération d'images photoréalistes à partir de texte : il suffit de saisir une description textuelle pour produire une image de style photoréaliste, transformant directement l'idée créative en visuel livrable et réduisant les coûts de dessin ou de prise de vue manuels.

Résolution et format contrôlables : les paramètres resolution et aspect_ratio permettent de spécifier une sortie 2K ou 4K ainsi que huit ratios largeur-hauteur, pour obtenir en un seul appel une image adaptée à l'emplacement cible, sans recadrage ultérieur.

Analyse de prompts complexes : des prompts allant jusqu'à 3000 caractères peuvent contenir des descriptions hiérarchisées de la scène, du sujet et de la composition ; des études indiquent que cette version améliore le respect des prompts et la précision des détails par rapport à la génération précédente.

Qualité d'image de niveau commercial : des études indiquent que son éclairage, le rendu des textures de peau et le rendu du texte s'approchent d'un rendu photographique, ce qui le destine à une livraison directe plutôt qu'à un simple brouillon.

Cas d'usage

Opérations e-commerce : génération en lot de visuels produits en situation — décrivez par texte le produit et l'ambiance de la scène pour produire des images principales et des visuels en situation haute résolution prêts à être publiés, destinés aux pages de détail produit et aux supports publicitaires.
Équipes marketing : affiches intégrant du texte — saisissez les exigences de mise en page et de copywriting pour générer des affiches et bannières au texte lisible, directement utilisables sur les réseaux sociaux et les emplacements publicitaires.
Cinéma et jeu vidéo : concept art et storyboards — générez en lot des images à partir de descriptions de scénario ou de références pour produire des concepts de design et des images de storyboard, servant aux discussions de préproduction et à la validation de la direction artistique.
Équipes design : visuels multi-formats — grâce aux multiples formats d'image et aux résolutions 2K/4K, produisez rapidement des visuels adaptés à différents terminaux, pour les propositions clients et les itérations.

Limites et conseils de sélection

Cette ligne n'accepte que des entrées textuelles ; pour éditer ou composer à partir d'images existantes, il convient de choisir la ligne image-to-image de la même série. Les études mentionnent que la génération en 4K exige une puissance de calcul et un temps de génération plus élevés ; les cas sensibles à la latence doivent donc évaluer le coût d'attente de la génération. Les descriptions de capacités sont surtout des améliorations relatives à Seedream 4.0 et manquent de comparaisons indépendantes avec d'autres modèles de la même période ; lors du choix, il est recommandé de tester les résultats sur ses propres échantillons métier avant de décider.

Questions fréquentes

Voir toutes les questions →

Quelle est la différence entre la génération d'images à partir d'images et à partir de texte avec Seedream 4.5 ?

L'endpoint image-to-image utilise l'image que vous téléchargez comme base d'édition, ce qui convient pour changer les couleurs, remplacer le décor, refaire l'éclairage, convertir le style et composer plusieurs images ; la génération texte-to-image, elle, crée une image de zéro à partir du texte uniquement. Lorsqu'il faut conserver le sujet, la composition ou le texte présent dans l'image, il est préférable d'utiliser le modèle image-to-image actuel.
Combien d'images de référence Seedream 4.5 prend-il en charge au maximum ?

Chaque requête peut téléverser de 1 à 14 images JPEG, PNG ou WebP, avec une taille maximale de 10 Mo par fichier ; le format SVG n'est pas pris en charge. Pour les tâches multi-images, vous pouvez spécifier explicitement l'usage de chaque image dans le Prompt avec « image 1 », « image 2 », etc. ; l'ordre doit correspondre à celui du tableau image_urls.
Comment est facturée l'édition d'images avec Seedream 4.5 ? Le nombre d'images de référence influence-t-il le prix ?

La facturation est basée sur les images de sortie générées avec succès, et non sur le nombre d'images de référence. Actuellement, les résolutions 2K et 4K utilisent le même tarif public ; le montant exact dépend du prix en temps réel sur la page du modèle et de l'historique des tâches.
Comment faire en sorte que Seedream 4.5 conserve le sujet, la composition ou le texte présent dans une image ?

Le prompt doit préciser à la fois « ce qu'il faut changer » et « ce qui doit rester inchangé », par exemple conserver le contour du sujet, l'angle de la caméra, l'ombre de contact, la disposition de la boutique ou le texte calligraphique. Vérifiez d'abord le résultat dans le Playground ; pour les contenus comportant du texte de marque et des exigences de mise en page strictes, il est recommandé de conserver une étape de révision humaine.

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-4.5/text-to-image

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour seedream-4.5/text-to-image et la route default — voir le tableau des paramètres ci-dessous.

promptstringRequisminLength 4maxLength 3000

Invite de texte décrivant le contenu de l'image à générer, sous forme de chaîne, longueur maximale de 3000 caractères.

resolutionstringRequisDéfaut: "2K"

Niveau de netteté de l'image de sortie, sous forme de chaîne ; 2K pour une qualité standard, 4K pour une ultra-haute définition ; 2K par défaut.

Options：2K4K

aspect_ratiostringRequisDéfaut: "1:1"

Rapport largeur-hauteur de l'image générée, sous forme de chaîne ; 1:1 par défaut.

Options：1:14:33:416:99:162:33:221:9

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-4.5/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }
}'

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-4.5/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "2K",
      "aspect_ratio": "1:1"
    }
  }),
});
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-4.5/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "2K",
          "aspect_ratio": "1:1"
        }
    },
)
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"
    }
  }
}