Introduction
Z-Image Base LoRA Image vers image redessine une image source sur Z-Image, le modèle de base de 6 milliards de paramètres de l’équipe Tongyi-MAI d’Alibaba, avec jusqu’à trois de vos propres fichiers LoRA chargés. Un réglage de force détermine à quel point le résultat s’éloigne de la source. La sortie garde le ratio d’image de la source. La plateforme n’ajoute aucun filtre de contenu au prompt, aux poids ni à l’image.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une description écrite | Z-Image Base LoRA Texte vers image |
| une image à restyliser | Z-Image Base LoRA Image vers image |
Fonctionnalités et points forts
Restylisez avec un LoRA, gardez la composition
Avec un LoRA de style à une force de 0,6, nos photos de test ont été redessinées en illustrations pendant que la pose, le cadrage et les vêtements restaient exactement en place.
Un seul réglage de force
La force va de 0 à 1 (0,7 par défaut). Sous 0,6, la source revient presque inchangée ; à partir d’environ 0,75, la scène est remise en pose et en scène sous la même lumière et avec la même palette.
Deux paliers de résolution
1k renvoie un grand côté de 1 024 pixels et 1.5k un grand côté de 1 536 pixels, dans le ratio d’image propre à la source. Les deux coûtent le même prix.
Aucun filtre de contenu
Les images sources peuvent être redessinées avec n'importe quel prompt. Rien n'est filtré à l'entrée ni à la sortie ; dans nos tests, le niveau Très fort est sorti flou plutôt que bloqué.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Décrivez l’image complète que vous voulez récupérer, pas seulement le changement. Placez d’abord la phrase déclencheur d’un LoRA. 1 caractères minimum · 5000 caractères maximum |
image_url | Oui | L’image à redessiner. Le résultat garde son ratio d’image ; le palier de résolution fixe le grand côté. |
resolution | Non | 1k renvoie un grand côté de 1 024 pixels et c’est la valeur par défaut ; 1.5k renvoie 1 536. Les deux coûtent le même prix, et le ratio d’image suit toujours la source. |
strength | Non | À quel point s’éloigner de la source, de 0 à 1 ; 0,7 par défaut. |
loras | Non | Jusqu’à trois entrées {path, scale} entraînées sur Z-Image Base ; scale de 0 à 4, 1 est neutre. Ici, c’est un LoRA de style qui fait l’essentiel de la restylisation. Valeur par défaut: |
output_format | Non | JPEG par défaut, ou PNG ou WebP. Le format ne change pas le prix. |
seed | Non | Garde les résultats comparables pendant que vous ajustez la force. Il ne garantit pas les mêmes pixels à chaque exécution. |
Tarification
$0.014 / image
Facturé à l’image, au même tarif que le texte vers image. Le palier de résolution, le format de sortie et le chargement de LoRA ne changent pas le prix.
Cas d’utilisation
De la photo à l’illustration
Chargez un LoRA d’illustration et passez-y vos photos à 0,6 pour obtenir une série illustrée assortie.
Des variantes d’une prise de vue
Entre 0,75 et 0,8, le modèle garde la lumière et l’ambiance d’une photo mais redessine la pose et le décor, ce qui est utile pour des prises alternatives.
Tester un LoRA entraîné sur des images réelles
Vérifiez comment un LoRA que vous avez entraîné sur Z-Image Base traite de vraies photographies avant de construire dessus.
Guide de prompt et conseils pratiques
Décrivez l’image entière
Écrivez l’image que vous voulez récupérer, pas le changement. « A woman in a green velvet dress singing on a dark stage » fonctionne ; « make it black and white » seul n’a pas fonctionné lors de nos tests.
Laissez le LoRA restyliser
Sans LoRA, les consignes pour changer le médium ou la tenue changeaient peu sous 0,8. Un LoRA de style a changé le médium à 0,6.
Choisissez la force selon la tâche
0,6 pour une restylisation qui garde tout en place, 0,7 pour de petits changements de contenu, 0,75 à 0,8 pour une nouvelle prise sur la scène, 0,85 et au-delà pour une nouvelle image.
Utilisez des LoRA Base
Un LoRA entraîné sur Z-Image Turbo a cassé l’image sur cette version lors de notre test. Utilisez des fichiers entraînés sur Z-Image Base.
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/z-image-base-lora/edit",
"input": {
"image_url": "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.
