Generazione di video

Crea un video da un testo: la richiesta, gli stati, il download e il prezzo al secondo.

Modelli video disponibili

720p, no sound

0,672 USD / secondo

1080p, no sound

0,896 USD / secondo

720p, with sound

1,008 USD / secondo

1080p, with sound

1,344 USD / secondo

720p, sound included

0,896 USD / secondo

1080p, sound included

1,12 USD / secondo

Come funziona il flusso

1. Invia POST /v1/videos/generations con il modello, un prompt e le opzioni. La risposta contiene un request_id.
2. I video vengono creati in modo asincrono, di solito in 1–3 minuti. Controlla lo stato ogni 10 secondi finché non diventa done o failed.
3. Quando lo stato è done, scarica il file dal percorso in video.url con la stessa chiave.

Richiesta

curl -sS https://api.oneprovider.dev/v1/videos/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0",
"prompt": "A red balloon rises over a quiet harbor at sunrise",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
# {"request_id":"task_..."}

Una combinazione che non è nella tabella dei prezzi viene rifiutata subito con un errore 400, e non viene addebitato nulla.

Stato

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID \
-H "Authorization: Bearer $ONEPROVIDER_KEY"
# {"request_id":"task_...","status":"pending","progress":50}
# {"request_id":"task_...","status":"done","progress":100,
# "video":{"url":"/v1/videos/generations/$REQUEST_ID/content","duration":5}}

Download

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID/content \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-o video.mp4

La risposta è un file video/mp4 e l'header Range è supportato. Salva subito il file sul tuo sistema; non contare sul fatto che il link funzioni per sempre.

Prezzi

Paghi per secondo di video alla tariffa della riga corrispondente nella tabella qui sopra (risoluzione e sonoro). L'addebito avviene una sola volta, quando lo stato diventa done; i video falliti o non terminati non vengono addebitati.

Esempio: kling-3.0, 720p, senza sonoro, 5 secondi = 0,672 USD × 5 = 3,36 USD.

Errori

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .