Riferimento API di Z-Image Base LoRA
Z-Image Base con fino a tre tue LoRA
Con una sola chiave API di PopNow chiami Z-Image Base LoRA 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
- 2.16 crediti per immagine ($0.0216)
- Tempo tipico
- circa 21 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/z-image-base-lora/text-to-image
Prezzo
| Opzione | Crediti (per immagine) | Dollari USA |
|---|---|---|
Predefinito | 2.16 | $0.0216 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | fino a 5000 caratteri | Describe the subject, clothing, place and light in sentences. Put a LoRA trigger phrase first. |
aspect_ratioFacoltativo | string | 1:1 | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21 | Output aspect ratio. |
lorasFacoltativo | array<object> | [] | fino a 3 elementi | Up to three LoRA weight files trained for Z-Image Base, each with its own strength. |
output_formatFacoltativo | string | jpeg | jpeg, png, webp | Container of the returned image. |
seedFacoltativo | integer | — | da 0 a 2147483647 | Random seed for controlled comparisons. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "alibaba/z-image-base-lora/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"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Modifica immagine
alibaba/z-image-base-lora/edit
Prezzo
| Opzione | Crediti (per immagine) | Dollari USA |
|---|---|---|
Predefinito | 2.16 | $0.0216 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | fino a 5000 caratteri | Describe the whole image you want back, not just the change. |
image_urlObbligatorio | string (uri) | — | — | Source image. The result keeps its aspect ratio. |
resolutionFacoltativo | string | 1k | 1k, 1.5k | Length of the output's long side: 1k is 1024 pixels, 1.5k is 1536. The source's aspect ratio is kept. |
strengthFacoltativo | number | 0.7 | da 0 a 1 | How far to move away from the source, from 0 to 1. |
lorasFacoltativo | array<object> | [] | fino a 3 elementi | Up to three LoRA weight files trained for Z-Image Base, each with its own strength. |
output_formatFacoltativo | string | jpeg | jpeg, png, webp | Container of the returned image. |
seedFacoltativo | integer | — | da 0 a 2147483647 | Random seed for controlled comparisons. |
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_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.
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/z-image-base-lora/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_url": "https://media.popnow.ai/influencer/examples/marco.webp"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"