Introduzione
Wan 2.7 Pro Modifica immagine rielabora immagini fornite con una modifica mirata. Usala quando l’immagine sorgente contiene dettagli che devono restare riconoscibili mentre cambia una decisione locale o stilistica.
Scegli la modalità di Wan 2.7 Pro in base al materiale di partenza
| Cosa hai all’inizio | Modalità |
|---|---|
| un brief visivo scritto | Wan 2.7 Pro Testo in immagine |
| un’immagine che richiede una modifica mirata | Wan 2.7 Pro Modifica immagine |
Caratteristiche principali
Fino a 4K, su text-to-image
Qui text-to-image lavora di default a 2k, circa 4 megapixel, e arriva a 4k, circa 16 megapixel, dove la famiglia standard si ferma a 2k. Image-to-image lavora a 2k. Il senso è proprio questa divisione: passa a 4k quando generi un'immagine principale che verrà ritagliata o stampata, non quando ricolori un packshot.
Luce di candela, pelle e pennellata
La seconda immagine di questa pagina è un interno pittorico: una figura contro un paravento controluce, una candela e un bicchiere di vino su un tavolo laccato. Lo sfumare morbido della luce, la pennellata visibile e un volto che regge a quella dimensione sono le prime cose a crollare su una tela piccola, ed è esattamente a questo che serve quella grande.
Tiene ogni frase di un’istruzione lunga
Su image-to-image la capacità in più va nel seguire istruzioni composte – prendi questo oggetto, mettilo su quella superficie, ricalca la luce della seconda immagine, non toccare la condensa. La famiglia standard lascia cadere una frase di un’istruzione così più spesso di quanto faccia questa.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Scrivi la modifica e l’elenco di ciò che non va toccato. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Da uno a nove riferimenti in un’unica chiamata. L’ordine conta: il prompt li richiama per posizione e l'ultimo fissa le proporzioni quando |
bounding_boxes | No | Rettangoli facoltativi che indicano dove deve avvenire la modifica, fino a due per immagine di riferimento. al massimo 18 elementi |
aspect_ratio | No | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 o 2:3. Nessun valore predefinito. |
color_palette | No | Tema cromatico facoltativo da 3 a 10 colori (ne sono consigliati 8). almeno 3 elementi · al massimo 10 elementi |
seed | No | Da 0 a 2147483647. Tienilo fisso su tutta una serie di varianti, così l’unica differenza tra due modifiche è la frase che hai cambiato. |
Prezzi
$0.075 / immagine
Casi d’uso
Adattare un’immagine approvata a un nuovo contesto di campagna
Invia il packshot e la superficie di destinazione come due riferimenti etichettati e chiedi di riprendere direzione della luce e temperatura colore del secondo. Condensa, etichetta e forma del vetro restano intatte perché l’hai detto in modo esplicito.
Esplorare un cambio controllato di direzione artistica
Tieni posa e guardaroba del riferimento e cambia la luce o l’ambientazione nella stessa istruzione. Le istruzioni composte sono proprio ciò per cui è tarato questo endpoint, quindi indica direzione della luce, temperatura colore e le parti che non devono muoversi.
Preparare una serie coerente di varianti
Fissa seed su tutta una serie di varianti perché l’unica differenza tra due modifiche sia la parte che hai cambiato. Ogni modifica gira su una superficie 2k, circa 4 megapixel; il 4k è disponibile solo sul testo in immagine.
Consigli avanzati
Di’ cosa deve restare e cosa può cambiare
Indica le sorgenti per posizione — immagine 1, immagine 2 — e scrivi la modifica seguita dall’elenco di ciò che non deve cambiare. Con da uno a nove riferimenti, indica il compito di ciascuno; l’ultimo fissa le proporzioni quando aspect_ratio è omesso.
Mantieni la revisione verificabile per parti
Ogni richiesta restituisce un’immagine. Costruisci una serie di varianti ripetendo la chiamata con il seed e tutto il resto fermi, cambia una parte alla volta e confronta ogni risultato con l’originale, non con la modifica precedente.
Verifica il risultato che dipende dalla sorgente
Ogni riferimento deve essere JPEG, PNG senza trasparenza, BMP o WEBP, da 240 a 8.000 pixel per lato, con un rapporto tra 1:8 e 8:1 e non oltre 20 MB. Un aspect_ratio diverso ricompone l’immagine invece di ritagliarla, quindi controlla che gli elementi mantenuti siano ancora al loro posto.
Avvio rapido dell’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/wan-2.7-pro/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
