Modelli

Ogni modello che puoi chiamare ha un ID modello, da inserire nel campo model di createTask. La tabella in fondo a questa pagina li elenca tutti con il prezzo di partenza; ogni nome porta a una pagina di riferimento con l’elenco completo dei parametri, le fasce di prezzo e una richiesta da copiare.

Com’è fatto un ID modello

<maker>/<model>/<task>
alibaba/wan-3.0/image-to-video
google/nano-banana-2.1/edit
popnow/background-remover-v1/edit

• maker è chi ha creato il modello. Gli strumenti realizzati da PopNow usano popnow.
• model mantiene i punti della versione: seedance-2.0, non seedance-2-0.
• task dice cosa fa la chiamata: text-to-image, edit, image-to-video, reference-to-video, video-extend, text-to-speech, text-to-audio e così via. La modifica delle immagini è sempre edit.

Una famiglia di modelli ha di solito più ID, uno per attività. Scegli quello adatto a ciò che invii: .../text-to-video vuole solo un prompt, .../image-to-video richiede un’immagine iniziale.

Leggi il catalogo dal codice

Fa fede il catalogo in tempo reale: include cosa è disponibile adesso e i prezzi che valgono per il tuo account.

# Every video model, with input schemas
curl "https://api.popnow.ai/api/v1/models?modality=video&includeSchema=1" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

# One model. The ID contains slashes; send it as it is.
curl "https://api.popnow.ai/api/v1/models/alibaba/wan-3.0/image-to-video" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Filtri dell’elenco: modality (image, video, audio), provider, task, search, più includeSchema=1 e includeExamples=1 per aggiungere schemi di input ed esempi di input validati. Se il tuo client HTTP tratta un parametro di percorso come un unico segmento, codifica le barre come %2F.

I campi da leggere

Leggere i prezzi

credits è lo stesso prezzo mostrato su popnow.ai, in crediti (1 credito = 0,01 $):

"credits": {
  "unit": "per_second",
  "perUnit": 6.75,
  "rules": [
    { "when": { "*": "480p" }, "perUnit": 6.75 },
    { "when": { "*": "720p" }, "perUnit": 13.5 },
    { "when": { "*": "1080p" }, "perUnit": 27 }
  ]
}

unit dice come cresce il prezzo (per_image, per_second, per_request, per_1k_characters), perUnit è il prezzo di partenza e ogni regola si applica quando la richiesta corrisponde ai suoi valori when (* indica l’impostazione che decide la fascia, qui resolution). L’addebito finale di un’attività viene arrotondato per eccesso ai crediti interi.

Per l’importo esatto di una richiesta specifica, chiedi a jobs/quote con lo stesso corpo che invieresti a createTask.

Schemi di input

inputSchema è JSON Schema standard (draft 2020-12). Alcune regole valgono per tutti i modelli:

• I campi sconosciuti vengono rifiutati. Un aspect_ration scritto male restituisce 400 invece di essere ignorato in silenzio.
• I nomi dei campi sono comuni a tutti i modelli. La stessa idea ha sempre lo stesso nome: prompt, negative_prompt, image_url, image_urls, video_url, audio_url, duration_seconds, aspect_ratio, resolution, seed, generate_audio.
• I valori predefiniti vengono aggiunti per te. Invia solo ciò che vuoi cambiare.
• I campi media accettano un URL HTTPS pubblico, un file popnow:// caricato da te o un asset salvato. Vedi Media.
• I suggerimenti di visualizzazione stanno in un oggetto x-ui su ogni proprietà (etichette, ordine, passo dei cursori). Non cambiano mai la validazione; ignora le chiavi che non conosci.

Se ometti seed su un modello che lo prevede, ne viene scelto uno a caso e restituito nell’input dell’attività, così puoi ripetere un risultato che ti piace.

Cache

Le risposte del catalogo sono private per il tuo account e si possono tenere in cache per 60 secondi. Uno schema sensato: tenere in cache l’elenco per qualche minuto, rileggere un modello quando cambia la sua version e trattare available: false come «riprova più tardi o scegli un altro modello».

Tutti i modelli che puoi chiamare

I prezzi sono la fascia più bassa per unità; risoluzioni più alte, clip più lunghe e opzioni extra costano di più. La pagina di ogni modello mostra tutte le fasce.