Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
image_url | Sì | L'immagine di partenza. |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti per immagine | ≈ USD |
|---|---|---|
| Standard | 7,5 | 0,075 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 8 crediti per immagine (0,08 USD).
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di Celebrity Look-Alike in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model popnow/look-alike-v1/edit e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
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: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/look-alike-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di Celebrity Look-Alike
Quanto costa l’API di Celebrity Look-Alike?
Celebrity Look-Alike costa 8 crediti (0,08 USD) per immagine. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di Celebrity Look-Alike nell’API?
Inserisci popnow/look-alike-v1/edit per Scambio volto nel campo model di POST /jobs/createTask.
Che cosa torna esattamente?
Un’immagine generata. L’endpoint non restituisce il nome della celebrità, né un elenco di candidati, né una percentuale di somiglianza: tutto ciò che il tuo prodotto mostra deve quindi costruirsi attorno all’immagine stessa.
Funziona con le foto di gruppo?
No. Invia un volto per richiesta. Con più volti nell’inquadratura non c’è modo di sapere a chi ti riferivi, e il risultato diventa arbitrario.
Posso regolare il risultato?
No. Non ci sono prompt, seed, dimensione né controllo del formato. La foto che invii è l’unico input che cambia l’esito.
È riconoscimento facciale?
Trattalo come tale quando decidi se puoi usarlo. Prende in input il volto di una persona reale, e questo lo colloca sotto le regole su dati biometrici e immagine personale in diverse giurisdizioni, a prescindere da come presenti la funzione nel tuo prodotto. Usalo solo con il consenso della persona ritratta e leggi la sezione Limits prima di pubblicarlo.
Posso usarlo su foto di celebrità o personaggi pubblici?
Non farlo. Inviare la foto di un personaggio pubblico, o presentare l’output come un’affermazione su una persona reale, è esattamente il punto in cui si violano i diritti all’immagine e allo sfruttamento del nome. L’input previsto è il ritratto di un utente che ha dato il consenso.
Posso provare Celebrity Look-Alike senza scrivere codice?
Sì. Il Playground esegue Celebrity Look-Alike con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.

