Workflow immagine Wan 2.7: genera un concept, poi modificalo

Usa Wan 2.7 da testo a immagine per un nuovo concept a 0,03 $/immagine e la modifica di Wan 2.7 per rivedere una sorgente esistente allo stesso prezzo. Scegli Pro a 0,075 $/immagine quando ti serve l'output in 4k, che offre solo Pro testo; Pro modifica restituisce sempre 2k. Generazione e modifica Standard offrono 1k o 2k e fino a quattro output per chiamata. Le impostazioni qui sotto costruiscono una copertina con un faro e poi rimuovono una barca indesiderata con un riquadro di modifica misurato.

Scegli prima l'endpoint

Per dare un'idea di scala: 1k è circa 1 megapixel, 2k circa 4 e 4k circa 16. Tutti e quattro accettano 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 e 2:3. Il testo è quadrato per impostazione predefinita. La modifica non ha un valore predefinito: segue le proporzioni dell'ultima immagine sorgente. Imposta esplicitamente 2:3 quando generi senza palette, così un riferimento successivo non decide la forma. aspect_ratio non si può combinare con color_palette né con bounding_boxes: una richiesta che li contiene entrambi restituisce l'errore 40004, quindi ometti aspect_ratio in quelle richieste (una richiesta testo con palette restituisce allora il quadrato predefinito; una modifica con riquadro mantiene le proporzioni dell'ultima sorgente). Nessuno dei quattro ha un selettore del formato di output.

Pro modifica è tarato per istruzioni lunghe con più proposizioni («prendi questo oggetto, mettilo su quella superficie, adatta la luce alla seconda immagine, non toccare l'etichetta»), quindi sceglilo per modifiche composte e non per la risoluzione.

Genera il concept della copertina

Usa la generazione di testo Standard con resolution: "2k", aspect_ratio: "2:3", num_outputs: 1, enable_thinking: true e il seed 314159. Un seed fisso mantiene stabile la condizione casuale di partenza mentre cambi una sola proposizione alla volta; omettilo per ottenere un risultato nuovo. Con enable_thinking disattivato si genera più in fretta; lascialo attivo finché esplori la composizione. Il prompt resta in inglese, così com'è:

Original painted cover artwork for a fictional coastal mystery. One white lighthouse on a charcoal rocky island above dark teal water, the entire tower visible slightly right of center. One small mustard-yellow lamp at its top. One fictional adult keeper aged 45 in a rust raincoat walks along a clear path toward the tower. The keeper is small relative to the building. Pale restrained sky with quiet space in the upper third for separately added typography. Strong large silhouettes, soft dusk light, no lettering, extra towers, boats or disaster spectacle.

Illustrazione, non un risultato Wan (il cielo è più caldo di quanto chieda il prompt): il piccolo guardiano dà la scala mentre il faro resta dominante.

Provalo prima nel Playground

1. Apri la pagina Wan 2.7 da testo a immagine e resta nella scheda Playground, in vista Form. Accedi con un account con credito per eseguire.
2. Incolla il prompt della copertina qui sopra in Prompt. Imposta Resolution su 2k e Seed su 314159; lascia Deep thinking attivo mentre esplori la composizione.
3. In Aspect ratio scegli 2:3. Se aggiungi una palette al passaggio 4, impostalo invece su Auto, perché i due non si possono combinare.
4. Facoltativo: in Color palette premi Add a color, inserisci ogni codice #RRGGBB e, se vuoi, la sua quota in percentuale (da 3 a 10 colori; la sezione successiva contiene il set del faro).
5. Esegui il modello, controlla la torre e la scala del guardiano, poi cambia una proposizione ed esegui di nuovo con lo stesso seed.

Per la modifica della barca, apri la pagina di modifica Wan 2.7, aggiungi l'immagine approvata in Images (Add a file o Asset URL) e trascina un riquadro sulla barca e sulla scia in Edit areas; Fine-tune coordinates mostra gli stessi numeri. Nel prompt riferisciti a «l'area contrassegnata». Il corpo della richiesta nel Playground è lo stesso JSON che accetta l'API, quindi una configurazione che funziona qui si può copiare direttamente nel codice.

La pagina di modifica Wan 2.7 in vista Form, con il campo Prompt e il pulsante Run.

Fornisci una palette valida

color_palette accetta da 3 a 10 colori esadecimali a sei cifre (8 è il numero consigliato) e orienta l'intera inquadratura: scena, abiti e luce. Ogni colore può avere un ratio, una quota percentuale; i colori senza quota si dividono equamente il resto. Considera le quote una distribuzione richiesta, non un conteggio misurato dei pixel. La richiesta del faro usa quattro colori per un totale di 100: #173E46 verde acqua scuro 45, #E8E1D3 cielo pallido 30, #34383A antracite 20 e #C9A448 senape 5. Ometti aspect_ratio quando li invii.

Se il giallo invade il cielo, togli dal prompt le espressioni di cielo dorato e caldo e riduci il ruolo dell'accento.

Rimuovi una barca con coordinate prese dalla sorgente reale

Supponi che l'immagine approvata contenga una barca che disturba. Passa alla modifica Standard, usa l'immagine approvata come prima sorgente e mantieni 2k e un output; ometti aspect_ratio, perché non si può combinare con bounding_boxes. Ogni voce di bounding_boxes indica una sorgente con image_index, numerato a partire da uno, e le sue coordinate sono pixel misurati dall'angolo in alto a sinistra di quella sorgente.

Per una sorgente ipotetica di 1200 × 1800 con barca e scia racchiuse tra (120,1180) e (390,1420), il riquadro è {"image_index": 1, "x1": 120, "y1": 1180, "x2": 390, "y2": 1420} e il prompt dice: "Remove the small boat and its wake inside the marked lower-left sea area. Continue the surrounding dark teal water and painterly texture. Retain the lighthouse, rocky island, adult keeper, path and quiet sky. No new objects or lettering."

Queste coordinate sono solo illustrative; misura la tua barca. Se un'anteprima mostra la stessa sorgente a 600 × 900, moltiplica per due le coordinate dell'anteprima: il punto (60,590) dell'anteprima diventa il punto (120,1180) della sorgente. Ricalcola dopo ogni ritaglio o ridimensionamento, perché il riquadro si riferisce sempre al file inviato, non alla dimensione di output richiesta.

Ogni sorgente accetta fino a due riquadri (diciotto su nove sorgenti). Includi la scia oltre allo scafo, altrimenti la barca resta visibile per implicazione. Il riquadro dice dove agire e il prompt cosa lo sostituisce; nessuno dei due garantisce pixel identici altrove. Usa da 1 a 9 immagini sorgente in JPEG, PNG opaco o WebP, ciascuna come URL HTTPS pubblico o file spicy:// caricato.

Con più sorgenti, di' a cosa serve ciascuna («l'immagine 1 è la scena, l'immagine 2 il cappotto, l'immagine 3 il riferimento di palette»).

Illustrazione, non un risultato Wan: materiali separati per sorgente, abbigliamento e palette, ciascuno con il proprio compito.

Poi eseguilo da codice

Installa l'SDK Python (pip install spicyapi), imposta SPICY_API_KEY nell'ambiente del tuo server ed esegui entrambi i passaggi: il concept e, quando hai un'immagine approvata, la rimozione della barca.

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

def run(model, input_data):
    task = client.create_task(model=model, input_data=input_data,
                              idempotency_key=str(uuid.uuid4()))
    final = client.wait_for_terminal(task["taskId"])
    if final["state"] != "succeeded":
        raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
    return output_assets(final)[0]["url"]  # copy the image to your own storage now

concept_url = run("alibaba/wan-2.7/text-to-image", {
    "prompt": "Painted cover for a fictional coastal mystery: one white lighthouse above dark teal sea on charcoal rocks, one small mustard-yellow lamp and one small adult keeper in a rust coat on a clear path. Pale quiet upper sky for later typography. Whole tower visible; no lettering or extra towers.",
    "resolution": "2k",
    "num_outputs": 1,
    "enable_thinking": True,
    "seed": 314159,
    "color_palette": [
        {"hex": "#173E46", "ratio": 45},
        {"hex": "#E8E1D3", "ratio": 30},
        {"hex": "#34383A", "ratio": 20},
        {"hex": "#C9A448", "ratio": 5},
    ],
})

edit_url = run("alibaba/wan-2.7/edit", {
    "image_urls": ["https://your-domain.example/approved-cover-1200x1800.jpg"],  # your approved image
    "prompt": "Remove the small boat and its wake inside the marked lower-left sea area. Continue the surrounding dark teal water and painterly texture. Retain the lighthouse, rocky island, adult keeper, path and quiet sky. No new objects or lettering.",
    "bounding_boxes": [{"image_index": 1, "x1": 120, "y1": 1180, "x2": 390, "y2": 1420}],
    "resolution": "2k",
    "num_outputs": 1,
    "seed": 314159,
})
print(concept_url, edit_url)

Creazione, attesa, download, nuovi tentativi e codici di errore sono nella guida ai task e nel riferimento dell'SDK Python. I risultati scadono, quindi leggi conservazione e consegna prima di basarti sul link restituito.

Oppure lascia che lo esegua un agente

Quando un assistente deve eseguire le generazioni, tutti e tre gli strumenti ufficiali mostrano il prezzo e chiedono conferma prima di una chiamata a pagamento.

• CLI. Metti l'oggetto input del concept in input.json, poi:

``bash spicyapi tasks create --model alibaba/wan-2.7/text-to-image --input-file input.json --wait ``

Per la modifica, spicyapi files upload <path> trasforma un'immagine locale in un link spicy:// per image_urls. Vedi la documentazione della CLI; npx @spicyapi/cli funziona senza installazione.

• Server MCP. Aggiungi il server MCP al tuo assistente, poi chiedi: «Run Wan 2.7 text to image with this prompt at 2k, seed 314159.» Chiama spicyapi_task_create, che si ferma per la conferma del prezzo, poi spicyapi_task_wait; spicyapi_upload_file gestisce un'immagine sorgente locale.
• Skill. npx skills add spicyapi-ai/spicy-skill installa l'Agent Skill, che fa leggere a un assistente di programmazione lo schema aggiornato del modello invece di indovinare i campi.

Correggi un risultato fallito specifico

Standard o Pro, e il costo

Un concept Standard più una modifica Standard costano 0,06 $. Una richiesta Standard con quattro output costa 0,12 $ e un'immagine Pro 0,075 $, quindi un passaggio Pro testo più Pro modifica costa 0,15 $. Esplora la composizione in Standard con num_outputs fino a 4. Paga Pro testo solo quando ti serve il 4k, ad esempio per un'immagine principale che sarà ritagliata o stampata, e Pro modifica quando una sola istruzione contiene più proposizioni che devono andare tutte a segno. Se è la composizione a essere sbagliata, una risoluzione più alta non la risolve.

Lavori per un pubblico adulto

Entrambi gli endpoint di modifica sono senza censura e SpicyAPI non aggiunge alcuna scansione dei contenuti. Possono consegnare modifiche destinate a un pubblico adulto, ma le modifiche più intense a volte tornano attenuate su uno dei due; Pro non garantisce un risultato più esplicito. L'attività di testo Standard a volte consegna immagini adulte avanzate, ma entrambe le attività di testo hanno attenuato le scene adulte più intense nei nostri test; un risultato attenuato viene comunque fatturato. Pro non elimina questo limite. Per i creatori di personaggi adulti, la via pratica è costruire prima l'immagine di base o il riferimento e poi applicare con la modifica i cambiamenti destinati a un pubblico adulto. I risultati registrati sono nell'articolo in inglese «Wan 2.7 Pro NSFW image test»; l'attività in sé si trova sulla pagina Wan 2.7 Pro modifica. La copertina con il faro di questa guida è completamente vestita e non richiede nulla di tutto ciò.

Per concludere

Tieni l'immagine approvata come sorgente per le revisioni mirate e inizia un nuovo concept quando deve cambiare la disposizione stessa dell'isola. Aggiungi il titolo esatto in uno strumento di design quando l'illustrazione funziona a dimensione di miniatura.