PopNowDocs API
Contenuto principale

Riferimento API di Wan 2.7

Ragiona sulla composizione, poi disegna fino a quattro immagini

Con una sola chiave API di PopNow chiami Wan 2.7 dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da
Alibaba
Risultato
Immagine
Da
4.5 crediti per immagine ($0.045)
Tempo tipico
circa 26 s

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Crea immagine

alibaba/wan-2.7/text-to-image

Prezzo

OpzioneCrediti (per immagine)Dollari USA
Predefinito4.5$0.045

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 5000 caratteriDescribe the image to generate: subject, composition, style, and lighting.
aspect_ratioFacoltativostring1:11:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3Aspect ratio of the generated image.
enable_thinkingFacoltativobooleantrue—Run the deep-thinking pass before generating. Turning it off generates faster.
num_outputsFacoltativointeger1da 1 a 4How many images to generate in one run.
resolutionFacoltativostring1k1k, 2kOutput resolution tier.
color_paletteFacoltativoarray<object>—fino a 10 elementiCustom colour theme: 3 to 10 colours, each with an optional share of the image in percent. Leave the shares empty to split them evenly.
seedFacoltativointeger—da 0 a 2147483647Random seed. Omit to let the model pick one.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "alibaba/wan-2.7/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
    "num_outputs": 1
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Modifica immagine

alibaba/wan-2.7/edit

Prezzo

OpzioneCrediti (per immagine)Dollari USA
Predefinito4.5$0.045

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 5000 caratteriDescribe the image to produce from the source: subject, composition, style, and lighting.
image_urlsObbligatorioarray<string (uri)>—fino a 9 elementiSource images that you are authorised to process.
bounding_boxesFacoltativoarray<object>—fino a 18 elementiRectangles marking the areas to edit, in pixels from the top-left corner of the reference image each one belongs to. Up to 2 per image.
aspect_ratioFacoltativostring—1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3Aspect ratio of the generated image. Omit it to follow the proportions of the last source image.
num_outputsFacoltativointeger1da 1 a 4How many images to generate in one run.
resolutionFacoltativostring1k1k, 2kOutput resolution tier. With aspect_ratio omitted, the output follows the last source image's proportions at this tier.
color_paletteFacoltativoarray<object>—fino a 10 elementiCustom colour theme: 3 to 10 colours, each with an optional share of the image in percent. Leave the shares empty to split them evenly.
seedFacoltativointeger—da 0 a 2147483647Random seed. Omit to let the model pick one.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in image_urls. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "alibaba/wan-2.7/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "num_outputs": 1
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Passi successivi

In questa pagina