Introduction
Qwen Image 2.1 LoRA Retouche d’image applique vos propres poids LoRA en reprenant de une à dix images de référence. C’est le même dispositif de poids personnalisés que sur le point de terminaison texte vers image, pointé cette fois sur un travail que vous avez déjà plutôt que sur une page blanche.
Il n’y a aucune validation des poids que vous chargez et aucun filtre de contenu sur le résultat.
Choisir un mode Qwen Image 2.1 LoRA selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| Des images sources plus vos propres poids | Qwen Image 2.1 LoRA Retouche d’image |
| Un brief plus vos propres poids | Qwen Image 2.1 LoRA Texte vers image |
| Retoucher sans poids personnalisés | Qwen Image 2.1 Retouche d’image |
Fonctionnalités et points forts
Amenez un LoRA de personnage sur un travail déjà engagé
Un LoRA avec lequel on ne peut que commencer quelque chose de neuf est bien moins utile qu’un LoRA qu’on peut appliquer à une image validée. Ce point de terminaison accepte les deux : jusqu’à dix références et jusqu’à trois fichiers de poids dans la même requête.
Poids et références résolvent deux moitiés différentes de la cohérence
Les références tiennent la composition, le décor et l’image précise ; le LoRA tient l’identité d’une image à l’autre. Les deux ensemble sont plus stables que l’un ou l’autre poussé à fond.
Sans censure des deux côtés
Aucune validation des poids, aucun filtre sur la sortie, et une source reste telle quelle tant que la consigne ne dit pas le contraire.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères. Cette famille n’a pas de prompt négatif, les exclusions ont donc leur place ici aussi. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De une à dix images de référence. Le modèle ne leur attribue pas de rôle tout seul : nommez dans le prompt ce qu’apporte chaque source. 1 éléments minimum · 10 éléments maximum |
aspect_ratio | Non | Compose le cadre avant la génération plutôt que de le recadrer ensuite. Quinze options, des bandes 3:1 et 21:9 aux colonnes 1:3 et 9:21. |
resolution | Non | Fixe la taille de sortie et le prix : 1k par défaut, 1.5k entre les deux, 2k là où la texture de la peau et les étoffes tiennent. Itérez en 1k, faites monter en 2k l’image retenue. |
loras | Non | Jusqu’à trois fichiers de poids, chacun {path, scale}. Valeur par défaut: |
output_format | Non | JPEG par défaut ; PNG pour la composition, WebP pour publier directement sur une page. Ne change ni le prix ni le rendu. |
seed | Non | Stabilise un tirage pour qu’une série reste dans le même voisinage. |
Tarification
| Spécification | Prix |
|---|---|
| $0.042 / image |
| $0.078 / image |
| $0.15 / image |
Cas d’utilisation
Appliquer un LoRA de personnage à des prises déjà validées
Le coûteux, dans une série, n’est presque jamais la génération : c’est d’arriver à une image que tout le monde a validée. Ce point de terminaison vous laisse garder cette image et changer qui s’y trouve — envoyez la composition validée en référence, chargez le LoRA de personnage, et laissez les poids porter l’identité pendant que la lumière, la mise en scène et le cadrage restent exactement où ils étaient.
Remettre un fonds ancien au style maison actuel
Pointez un LoRA de style sur des images générées il y a des mois. Envoyez les anciennes images en références, chargez les poids de style à une intensité modérée, et relancez-les pour qu’une image d’archive et une image neuve cohabitent sur la même page sans couture visible entre elles.
Scènes construites à partir d’une référence que vous maîtrisez
Partez d’une figure que vous avez déjà générée et ajoutez le deuxième sujet, la tenue, la contrainte ou le décor. Les consignes sont exécutées telles qu’elles sont écrites et les poids sans censure se chargent sans validation : la scène peut donc s’assembler par étapes au lieu de se jouer sur un seul prompt.
Changer la tenue et le lieu en gardant la personne fixe
Deux références — une qui porte la personne, une qui porte le vêtement ou la pièce — plus un LoRA de personnage, et un prompt qui dit quelle source est laquelle. Changez la pièce, gardez le visage ; changez la tenue, gardez les deux.
Guide de prompt et conseils pratiques
Nommez ce qu’apporte chaque référence avant de nommer le changement
Le modèle ne déduit les rôles ni de l’ordre ni du nom de fichier. Écrivez-le : « la première image est la femme, la deuxième est la pièce où elle se tient, la troisième est le manteau. » Sans cette phrase, une requête à plusieurs références mélange les sources au lieu de retoucher avec elles, et le résultat ressemble à un artefact de moyenne plutôt qu’à une erreur que vous pouvez déboguer.
Ne laissez pas le prompt et le LoRA décrire la même chose
Quand un LoRA de personnage est chargé, décrivez la scène, l’action et la lumière — pas le visage. Redire des traits que les poids encodent déjà tire le rendu dans deux directions et produit en général quelque chose qui ne ressemble ni à l’un ni à l’autre. Laissez le LoRA posséder l’identité et le prompt posséder tout ce qui l’entoure.
Mettez les protections dans la consigne, puisqu’il n’y a pas de prompt négatif
Dites clairement ce qui doit survivre à la retouche : « garde-la exactement comme dans la source, n’ajoute rien à sa tenue » ou « ne change pas la longueur des cheveux ». Un modèle de retouche laissé à son propre jugement range des choses que vous ne lui avez pas demandé de ranger, et sur du travail adulte ce rangement est précisément le mode de défaillance.
Chiffrez la requête avant de l’envoyer, pas après
Deux choses font bouger le coût ici en même temps : le nombre de références et le palier de résolution, avec le supplément LoRA par-dessus. Dix références avec trois LoRA en 2k est la forme la plus chère que cette famille accepte. L’estimation affichée avant envoi fait foi : lisez-la sur les grosses requêtes au lieu de supposer que le palier suffit à fixer le prix.
Vérifiez qu’un nouveau LoRA change quelque chose avant de lui confier un lot
Des poids prévus pour une autre architecture de base peuvent se charger sans erreur et n’avoir presque aucun effet visible. Lancez un prompt délibérément évident sur des poids neufs, confirmez que la sortie a bougé, puis lancez le lot.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-2.1-lora/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
