Génération de vidéos

Créez une vidéo à partir d’un texte : la requête, les statuts, le téléchargement et le prix par seconde.

Modèles vidéo disponibles

720p, no sound

0,672 $US / seconde

1080p, no sound

0,896 $US / seconde

720p, with sound

1,008 $US / seconde

1080p, with sound

1,344 $US / seconde

720p, sound included

0,896 $US / seconde

1080p, sound included

1,12 $US / seconde

Comment se déroule le processus

1. Envoyez POST /v1/videos/generations avec le modèle, un prompt et les options. La réponse contient un request_id.
2. Les vidéos sont générées de façon asynchrone, en général en 1 à 3 minutes. Vérifiez le statut toutes les 10 secondes jusqu’à ce qu’il passe à done ou failed.
3. Quand le statut est done, téléchargez le fichier depuis le chemin indiqué dans video.url avec la même clé.

Requête

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_..."}

Une combinaison absente du tableau des prix est rejetée aussitôt avec une erreur 400, et rien n’est débité.

Statut

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}}

Téléchargement

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

La réponse est un fichier video/mp4 et l’en-tête Range est pris en charge. Enregistrez le fichier de votre côté tout de suite ; ne comptez pas sur le fonctionnement éternel du lien.

Tarifs

Vous payez à la seconde de vidéo au tarif de la ligne correspondante du tableau ci-dessus (résolution et son). Le débit a lieu une seule fois, quand le statut passe à done ; les vidéos en échec ou inachevées ne sont pas facturées.

Exemple : kling-3.0, 720p, sans son, 5 secondes = 0,672 $US × 5 = 3,36 $US.

Erreurs

Réponses rapides

Quelle base URL utiliser ?

Claude Code et les SDK Anthropic utilisent https://api.oneprovider.dev. Les SDK OpenAI et les clients compatibles OpenAI utilisent https://api.oneprovider.dev/v1. Une seule clé fonctionne avec les deux ; la liste des modèles est sur la page des modèles , les tarifs sur la page des tarifs .

Comment s’authentifier ?

Envoyez la clé sk-… telle quelle dans x-api-key ou Authorization: Bearer : l’un des deux, jamais les deux. Conservez la clé dans une variable d’environnement, pas dans un fichier qui sera commité. En savoir plus sur l’authentification .

Où obtenir une clé ?

Ouvrez votre espace client dans le bot Telegram @oneprovider_robot ou sur app.oneprovider.dev, rechargez le solde et appuyez sur « Créer une clé ». Chaque clé peut avoir sa propre limite de dépense. Espace client et clés API .

Que signifient 401, 404 et 429 ?

401 : la clé est absente, mal saisie ou envoyée dans le mauvais en-tête ; collez la clé entière, sans guillemets ni espaces. 404 : le plus souvent une base URL incorrecte, par exemple un /v1 manquant ou en double. 429 avec « Insufficient balance » : le solde de l’espace client est à zéro ou la clé a atteint sa limite de dépense, donc rechargez au lieu de réessayer ; tout autre 429 est une limite de débit, donc attendez le délai indiqué par Retry-After. Détails : codes d’erreur et dépannage .

Pourquoi les flux se coupent-ils ou se réinitialisent-ils ?

Les VPN et les proxys VLESS mettent souvent le SSE en mémoire tampon ou perturbent la négociation HTTP/2. OneProvider n’a aucune restriction régionale et ne met pas les flux en mémoire tampon : désactivez le proxy et réessayez.

Où demander de l’aide si cela ne suffit pas ?

Écrivez à @Oneproviderhelpbot sur Telegram ou ouvrez « Support » dans l’espace client web, en indiquant le code de statut HTTP et le message d’erreur exact. Comment fonctionne le support .