La retouche Seedream 4.0 accepte de 1 à 10 images de référence et renvoie une image à la taille choisie parmi seize préréglages. Elle coûte 0,03 $ par image, quelle que soit la taille et le nombre de références. Il n'y a ni masque, ni curseur d'intensité, ni seed : tout le contrôle passe par le prompt. Servez-vous-en pour changer une tenue, un arrière-plan ou un éclairage, ou pour transformer un croquis en rendu, pas pour des retouches où chaque autre pixel doit rester intact.
SpicyAPI n'ajoute aucun filtre de contenu supplémentaire au niveau de la plateforme sur cet éditeur. Lors de nos tests de septembre 2026, des retouches adultes de plus forte intensité sont parfois revenues plus atténuées que demandé alors que la tâche s'affichait comme réussie : vérifiez l'image avant de l'utiliser.
Donner un rôle à chaque référence
Envoyez les images dans image_urls et désignez-les dans l'ordre : image un, image deux, etc. Une référence que vous ne mentionnez pas n'est pas ignorée, elle est fondue dans le résultat. Donnez à chaque source un seul rôle et dites ce qui doit être conservé.
Pour changer une tenue, importez une image validée d'un adulte fictif en veste simple, choisissez 1728*2304 et utilisez :
Conserve le visage, la coiffure, la pose, les mains, le point de vue de la caméra et l'arrière-plan de l'adulte fictif de l'image un. Remplace uniquement la veste par un blazer en velours bordeaux opaque, porté sur la chemise crème existante. Garde la longueur d'origine de la veste et la forme des épaules. Montre un léger lustre de velours sous l'éclairage existant, avec des revers nets, sans nouveau bijou ni texte.
« Rends la tenue plus luxueuse » laisse la coupe ouverte et peut renvoyer un costume tout autre. Pour reproduire un blazer précis, ajoutez-le comme image deux et remplacez la phrase sur la matière par : « L'image deux définit la coupe, les revers et le tissu du blazer bordeaux. Utilise uniquement ce vêtement ; garde la personne, la pose et la scène de l'image un. » Recadrez la photo du vêtement sur le vêtement lui-même : une photo de mode complète apporte aussi son visage, son corps et son éclairage.
SpicyAPI accepte jusqu'à dix références. Chaque fichier peut être un JPG, PNG, WEBP ou GIF de 10 Mo maximum, pour des images dont vous détenez les droits.
Choisir la taille exacte
Seedream 4.0 prend size sous forme de chaîne width*height, et non les champs resolution et aspect_ratio des modèles 5.0. La valeur par défaut est 2048*2048. Le résultat est reconstruit au préréglage choisi au lieu d'être recadré depuis la source : une source en portrait envoyée avec le carré par défaut est recomposée, et son cadrage peut changer. Adaptez la taille à la forme de la source.
| Forme visée | Taille standard | Taille supérieure |
|---|---|---|
| Carré | 2048*2048 | 3072*3072 |
| Paysage 4:3 | 2304*1728 | 3456*2592 |
| Portrait 3:4 | 1728*2304 | 2592*3456 |
| Paysage 3:2 | 2496*1664 | 3744*2496 |
| Portrait 2:3 | 1664*2496 | 2496*3744 |
| Paysage 16:9 | 2848*1600 | 4096*2304 |
| Portrait 9:16 | 1600*2848 | 2304*4096 |
| Ultra-large (21:9) | 3136*1344 | aucune |
1024*1024 est le dernier préréglage. Les autres dimensions sont rejetées. 4096*2304 est le plus grand cadre parmi les éditeurs Seedream de SpicyAPI ; 5.0 Lite s'arrête à 3136*1344.
Il n'existe pas de préréglage 4:5. Pour une carte 4:5 destinée aux réseaux sociaux, utilisez 1728*2304 en prévoyant de la marge pour un léger recadrage, ou passez à Seedream 5.0 Flash (0,029 $ par image) ou 5.0 Pro, qui acceptent aspect_ratio: 4:5. Pro démarre à 0,036 $ par image et coûte plus cher en 2K et avec des références supplémentaires.
Essayer d'abord dans le Playground
Lancez la retouche dans le Playground avant d'écrire du code : un résultat mauvais ici le sera aussi via l'API, et la solution est un meilleur prompt ou une meilleure référence.
- Ouvrez la page de retouche Seedream 4.0 et restez sur l'onglet Playground, en vue Form. Connectez-vous avec un compte approvisionné pour lancer.
- Ajoutez vos sources sous Images : déposez un fichier ou collez un lien avec Add URL. Jusqu'à 10 ; l'ordre d'ajout correspond à « image un », « image deux ».
- Décrivez la modification dans Prompt en indiquant ce que chaque image apporte et ce qui doit être conservé.
- Choisissez Output size selon la forme de la source.
- Vérifiez l'estimation du prix, puis lancez. La vue JSON affiche le corps de la requête, que vous pouvez copier dans votre code.
Puis l'appeler depuis le code
Installez le SDK Python (pip install spicyapi), définissez SPICY_API_KEY dans l'environnement de votre serveur, puis exécutez :
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
task = client.create_task(
model="bytedance/seedream-4.0/edit",
input_data={
"image_urls": [
"https://example.com/person.png",
"https://example.com/blazer.png",
],
"prompt": "Keep the person, pose and scene from image one. Image two defines the burgundy blazer cut, lapels and fabric; use its garment only.",
"size": "1728*2304",
},
idempotency_key=str(uuid.uuid4()),
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")
print(output_assets(final)[0]["url"]) # copy it to your own storage nowRemplacez les deux URL d'exemple par les vôtres ; elles doivent être accessibles sans connexion, ou bien importez un fichier local et passez l'URI spicy:// renvoyée. Le lien du résultat expire au bout d'environ 20 minutes (détails sur la conservation). Les devis, imports, attentes, nouvelles tentatives et erreurs sont décrits dans la référence du SDK Python et le guide des tâches asynchrones.
Ou laisser un agent l'exécuter
Si un assistant doit lancer les retouches à votre place, donnez-lui la CLI, le serveur MCP ou le Skill. La CLI et le serveur MCP affichent le prix et vous demandent confirmation avant tout appel payant.
- CLI. Placez le même objet
inputdansinput.json, puis lancez la commande suivante (npx @spicyapi/clifonctionne sans installation ; voir la documentation de la CLI) :
``bash spicyapi tasks create --model bytedance/seedream-4.0/edit --input-file input.json --wait ``
- Serveur MCP. Ajoutez le serveur MCP à votre assistant, puis demandez : « Retouche ./portrait.png avec Seedream 4.0 : remplace uniquement la veste par un blazer en velours bordeaux, taille 1728*2304. » Il appelle
spicyapi_upload_file, puisspicyapi_task_create, qui s'arrête pour obtenir votre confirmation du prix, puisspicyapi_task_wait. - Skill.
npx skills add spicyapi-ai/spicy-skillinstalle l'Agent Skill, qui fait lire à un assistant de code le schéma du modèle en direct au lieu de deviner les champs.
Transformer un croquis en concept de matière
Placez le croquis en premier et un échantillon de matière en second, et dites ce qui revient à chacun. Un exemple d'horloge fictive :
Transforme le croquis d'horloge de l'image un en concept produit réaliste. Conserve son boîtier arqué continu, son cadran circulaire crème centré et ses deux pieds courts. Utilise l'image deux uniquement pour la couleur et le grain du noyer. Donne aux pieds une finition laiton mate et au cadran deux aiguilles noires simples. Vue de face sur une surface de pierre claire, lumière latérale douce, sans marque ni objet supplémentaire.
La même répartition vaut pour un costume : le dessin fixe la silhouette, une image de tissu la surface, un portrait validé la personne fictive qui le porte. Utilisez un croquis propre, sans traits abandonnés. Un croquis de face seul ne peut pas définir une vue de côté ; demandez donc d'abord un résultat de face si le contour compte.
Corriger des échecs précis
La nouvelle tenue a changé le visage. Revenez au portrait d'origine, retirez les autres personnes de la référence du vêtement et gardez la vue d'origine. Si le visage doit rester exact au pixel près, incrustez le visage validé de façon classique au lieu de demander un nouveau redessin complet.
La matière a débordé sur d'autres objets. Nommez la surface : le velours ne concerne que le blazer, la chemise reste en coton crème ; le noyer concerne le boîtier de l'horloge, pas le cadran ni les pieds en laiton. Un échantillon étroit est plus clair qu'une pièce entière utilisée comme image de « style ».
La silhouette du croquis a changé. Simplifiez le croquis et demandez une vue de face. Un angle spectaculaire peut masquer le contour que vous vouliez garder.
Le sujet est coupé. Choisissez un préréglage adapté à la forme et demandez de la marge autour de la tête, des pieds ou de l'accessoire.
Un petit logo ou une phrase est erroné. Gardez la scène et remplacez cet élément dans un éditeur classique. Sans masque, corriger un texte revient à un nouveau redessin, pas à une retouche locale.
Les retouches répétées dérivent. Chaque passage redessine le cadre. Pour des changements cumulatifs, partez du dernier résultat accepté et vérifiez ce qui a bougé ; si vous revenez à l'original, incluez tous les changements acceptés dans le prompt. Lancez les variantes indépendantes à partir d'un original commun.
Coût et cas où choisir un autre modèle
Trois retouches coûtent 0,09 $ et dix coûtent 0,30 $. Les tailles supérieures et les références supplémentaires n'ajoutent rien. Pour une nouvelle image sans source, utilisez Seedream 4.0 texte vers image, qui a les mêmes tailles et le même prix.
Choisissez 4.0 pour de grands cadres jusqu'à 4096*2304 à tarif fixe. Choisissez un modèle 5.0 si vous avez besoin d'un aspect_ratio comme 4:5, d'une sortie PNG (tous les modèles 5.0) ou de fonds transparents (Flash et Pro). Choisissez une autre méthode si vous avez besoin d'un masque, de pixels conservés ou d'une géométrie d'ingénierie exacte. Pour des visuels publicitaires à partir de photos produit, voir de la photo produit au visuel publicitaire.
