ByteDance

Seedream 4.5

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

Prix unitaire	$0.045

Présentation

La ligne d'édition d'images Seedream 4.5 s'adresse aux développeurs qui souhaitent effectuer des modifications contrôlées à partir de supports existants. Elle accepte de 1 à 14 images de référence ainsi qu'une instruction d'édition, et produit une image en résolution 2K ou 4K, avec un rapport d'aspect sélectionnable entre 1:1 et 21:9. Elle convient aux workflows de génération d'images en série pour le e-commerce, le marketing et les concepts cinématographiques : il s'agit à la fois de prolonger les personnages, produits ou scènes des images de référence et d'ajuster les détails de l'image selon une instruction textuelle, afin de produire des images haute résolution directement utilisables pour la livraison.

Points clés

Workflow d'édition piloté par plusieurs images de référence — jusqu'à 14 images de référence peuvent être soumises en une fois, pour fusionner plusieurs éléments ou conserver la cohérence du sujet avant de réécrire l'image selon l'instruction.
Résolutions natives 2K et 4K au choix — la résolution de sortie est spécifiée directement dans les paramètres ; le palier 4K vise les livraisons commerciales nécessitant des images haute résolution.
Des formats couvrant les compositions horizontales, verticales et panoramiques — prise en charge de huit formats dont 1:1, 4:3, 16:9 et 21:9 ; la mise en page peut être verrouillée avant la génération, ce qui réduit les recadrages ultérieurs.

Capacités

Réécriture d'image pilotée par instruction : une instruction d'édition de 3000 caractères maximum décrit l'effet visé ; le modèle réalise la réécriture tout en conservant le contenu des images de référence, ce qui réduit le coût des itérations de redessin répétées.

Fusion multi-images et continuité du sujet : de 1 à 14 images de référence peuvent être fournies simultanément, permettant de combiner plusieurs supports dans une même image ou de maintenir la forme et la texture d'un personnage ou d'un produit d'un plan à l'autre.

Résolution et format au choix : la sortie prend en charge deux paliers, 2K standard et 4K ultra haute définition, associés à huit rapports d'aspect, pour produire directement des images conformes aux exigences des emplacements publicitaires et de la mise en page.

Rendu du texte dans l'image : bonne capacité de restitution des textes de type étiquettes et panneaux présents dans l'image, adaptée à la génération de visuels nécessitant du texte visible.

Cas d'usage

Opérations e-commerce : changer le décor à partir de photos produit réelles — fournir une image de référence du produit et une description de scène pour obtenir des visuels produit sous plusieurs angles, destinés aux pages de détail et aux supports publicitaires.
Design marketing : décliner des supports à partir du visuel principal — utiliser un visuel principal existant comme référence et générer en série des supports horizontaux et verticaux dans différents formats, pour les canaux internes et les réseaux sociaux.
Cinéma et storyboard : générer des images en conservant l'apparence des personnages — soumettre des images de référence de personnages et des instructions de storyboard pour produire une suite de plans cohérents, destinés aux discussions sur le storyboard et la conception.

Limites et conseils de choix

Les images de référence doivent être des liens jpeg, png ou webp accessibles publiquement, de 10 Mo maximum chacune ; le format SVG n'est pas pris en charge. La longueur de l'instruction est limitée entre 4 et 3000 caractères ; au-delà, il convient de la condenser. La sortie 4K et la combinaison de plusieurs images de référence augmentent la latence de génération et ne conviennent pas aux scénarios interactifs sensibles à la réactivité. Si le besoin est de générer à partir de zéro, sans support de référence, il faut plutôt choisir la ligne de génération texte-image de la même famille ; si une sortie non image est requise, cette ligne ne s'applique pas.

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

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

promptstringRequisminLength 4maxLength 3000

Instruction d'édition décrivant l'effet d'image attendu, longueur maximale de 3000 caractères.

image_urlsarrayRequisminItems 1maxItems 14

Tableau d'images de référence en entrée, de 1 à 14 images ; chaque image doit être accessible publiquement via une URL, au format jpeg/png/webp, ne dépassant pas 10 Mo par image ; le format SVG n'est pas pris en charge.

Array [ string ]

resolutionstringRequisDéfaut: "2K"

Résolution de l'image de sortie ; 2K correspond à une qualité standard, 4K à une qualité ultra-haute définition ; la valeur par défaut est 2K.

Options：2K4K

aspect_ratiostringRequisDéfaut: "1:1"

Rapport largeur/hauteur de l'image générée ; la valeur par défaut est 1:1.

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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "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"
    }
  }
}