Best take
DisponibleSend up to eight takes of the same shot. Get them ranked best first on sharpness, exposure and how often a face is in frame.
Best take
Entrée
video_urlsPublic https links to takes of the same shot.- mirror-take-1-eaf3e67f.mp4
- mirror-take-2-61c522e6.mp4
- mirror-take-3-b3ddf51c.mp4
Takes of the same shot, up to 8, each up to 10 minutes.
Free: nothing is held or charged.
These tools need an API key with the api:opennan scope: paste one under Use API key to run them.
Comment ça marche
- 01Send the takesUp to eight https links to the same shot.
- 02We score themSharpness, exposure and faces, frame by frame.
- 03Pick the bestEvery take scored, best first.
Appelez Best take depuis votre code
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/ / api.opennan.com/ v1/ qc/ best-takesObtenez une clé d’API
Créez une clé dans la console. Elle utilise le même solde que le playground.
Créer une cléEnvoyez votre première requête
La même requête que celle du playground. Définissez OPENNAN_KEY avec votre clé.
curl https://api.opennan.com/v1/qc/best-takes \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"video_urls":["https://cdn.opennan.com/examples/best-take/mirror-take-1-eaf3e67f.mp4","https://cdn.opennan.com/examples/best-take/mirror-take-2-61c522e6.mp4","https://cdn.opennan.com/examples/best-take/mirror-take-3-b3ddf51c.mp4"]}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"Suivez la tâche
L’appel répond tout de suite avec un id de tâche. Interrogez la tâche jusqu’à ce qu’elle se termine :
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- En attente d’un worker
- running
- En cours de création
- succeeded
- Terminé : outputs[].url contient les fichiers
- failed
- Échec : rien n’est facturé
Erreurs et solutions
401Clé manquante ou incorrecte
Envoyez l’en-tête Authorization: Bearer avec une clé de la console.
402Solde insuffisant
Ajoutez du crédit dans Facturation, puis renvoyez le même appel.
400Une valeur est refusée
Lisez error.message : il nomme le champ. Utilisez une valeur du tableau des paramètres.
429Trop de requêtes
Attendez quelques secondes et réessayez, un peu plus longtemps après chaque 429.
Ajoutez Opennan à votre app d’IA
Une seule installation donne à votre IA tous les outils Opennan : vidéo, images, chat, voix, musique, effets sonores, 3D, sous-titres et doublage. Choisissez votre app et suivez les étapes.
https:/ / api.opennan.com/ v1/ mcpFonctionne dans Codex CLI, l’app Codex et l’extension Codex pour IDE : elles partagent ~/.codex/config.toml. Si l’app ou l’IDE ne voit pas OPENNAN_KEY, utilisez l’option config.toml avec votre clé. Codex demande avant chaque appel d’outil : approuvez pour continuer.
Obtenez une clé API
Créez une clé dans la console. Elle commence par sk- et utilise le même solde que le site.
Créer une cléEnregistrez votre clé sous OPENNAN_KEY
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Installez le plugin Opennan : le serveur et un skill qui apprend à votre IA à choisir les modèles, confirmer les prix et attendre les résultats
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanOu ajoutez seulement le serveur
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOu ajoutez ceci à ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Vérifiez que opennan est dans la liste
codex mcp listRedémarrez Codex, puis demandez ce que vous voulez
“Fais une vidéo de 5 secondes de pluie dans une rue au néon, une chanson pour l’accompagner et une affiche.”
Remplacez sk-... par votre propre clé et gardez-la privée : toute personne qui l’a peut dépenser votre solde. Votre app peut lister les outils sans clé ; il en faut une pour créer quoi que ce soit.
Utilisez-le depuis un agent IA
Ajoutez le serveur MCP d’Opennan à votre agent et appelez cet outil.
- Outil
- best_take_score
- Arguments d’exemple
{ "video_urls": [ "https://cdn.opennan.com/examples/best-take/mirror-take-1-eaf3e67f.mp4", "https://cdn.opennan.com/examples/best-take/mirror-take-2-61c522e6.mp4", "https://cdn.opennan.com/examples/best-take/mirror-take-3-b3ddf51c.mp4" ] }
Best take : questions
Combien coûte Best take ?
C’est gratuit : it needs an API key with the api:opennan scope, and runs are rate limited per account.
Comment l’appeler depuis mon code ?
Envoyez POST https://api.opennan.com/v1/qc/best-takes avec votre clé d’API. La réponse est un id de tâche : interrogez https://api.opennan.com/v1/tasks/{id} jusqu’à la réussite ou l’échec de la tâche.
Mon agent IA peut-il l’utiliser ?
Oui. Ajoutez le serveur MCP https://api.opennan.com/v1/mcp et appelez l’outil best_take_score, ou indiquez https://api.opennan.com/llms.txt à votre agent.
Which API key do I need?
A key with the api:opennan scope. A full api key does not include it: create one with that scope in the console, then use it here under Use API key or in your code.