Avant de commencer : récupère ta clé API
Tout ce qui suit — l'agent, les images, la vidéo, les appels directs à l'API — utilise cette unique clé.
- Ouvre la console Octer : octer.ai/workspace/o/ → (pas de compte ? inscris-toi d'abord)
- Sur la page OClaw, clique sur copier pour obtenir une clé commençant par
sk-.
🎁 Les nouveaux utilisateurs reçoivent des crédits d'essai à l'inscription — récupère ta clé et essaie tout gratuitement avant de dépenser quoi que ce soit. S'inscrire et recevoir les crédits →
Prends une seconde pour vérifier que la clé fonctionne (choisis d'abord ton système, puis copie — une réponse JSON signifie que la clé et le réseau vont bien) :
Dans toutes les commandes ci-dessous, remplace sk-YOUR_KEY par ta propre clé.
Pas de JSON en retour, ou une erreur 401 / 403 ? Le « Dépannage → » donne la solution pour chaque cas.
Connecter ton agent
OpenClaw et Hermes sont des assistants IA locaux, gratuits et open source — ils tournent sur ton propre ordinateur et tu discutes avec eux dans un terminal. Jamais installé ? L'étape 1 ci-dessous te guide depuis zéro.
Choisis ton agent et ton système : toutes les commandes ci-dessous s'adaptent automatiquement.
Étape 1 · Installer le client
Vérifie que la commande est disponible :
Étape 2 · Basculer sur un modèle Octer
Le script écrit l'adresse de l'API, la clé et le modèle, redémarre la passerelle et envoie un « bonjour » de test — une réponse normale et c'est réglé.
Étape 3 · Vérifier
Exécutez ces deux commandes l'une après l'autre :
Tu changes d'avis ? Reviens en arrière
Cette commande efface la configuration du modèle Octer et laisse le reste de tes réglages intact.
Images et vidéo
L'étape précédente ne couvre que le chat. Pour que ton agent génère aussi des images et des vidéos, ajoute le skill oclaw — un petit outil en ligne de commande qui regroupe les trois capacités et enregistre directement sur ta machine ce qu'il génère.
Le plus simple : colle cette phrase dans le chat de OpenClaw / Hermes et l'agent l'installe tout seul.
Pas encore d'OpenClaw / Hermes ? Voir « Connecter ton agent → » — deux commandes suffisent. Sans agent ? Utilise la méthode terminal ci-dessous.
Remplace par ta propre clé. Ensuite, dis simplement « génère-moi une image de… » ou « fais une vidéo de… » en langage courant — l'agent s'occupe du reste.
Tu peux aussi l'utiliser depuis le terminal (aucune dépendance à part Python 3) :
Sous Windows : cet outil est un script bash — lancez-le dans WSL ou Git Bash (il ne fonctionne pas directement sous PowerShell).
- Les images arrivent dans
images/, les vidéos dansvideos/. - La vidéo est asynchrone : il faut en général 1 à 3 minutes, et l'outil attend puis télécharge pour toi. En cas de dépassement du délai, rien n'est perdu — la tâche tourne toujours. Lance
./oclaw.sh statuspour retrouver l'identifiant de la tâche, puis./oclaw.sh watch <task-id>. - Les liens vidéo expirent au bout d'environ 24 heures : télécharge dès que la tâche est terminée. L'outil le fait déjà — si tu appelles l'API toi-même, ne te contente pas de stocker l'URL.
Appeler l'API directement
Pas besoin d'agent : pour brancher Octer sur ton propre programme, il suffit d'appeler l'API HTTP. La passerelle parle le protocole OpenAI, donc un SDK officiel fonctionne avec pour seul changement une nouvelle base_url.
Modèles
Le model id est ce qu'il faut mettre dans un appel API ou la configuration d'un agent — c'est la chaîne surlignée dans le tableau ; le bouton juste à côté la copie en un clic.
| Type | Modèle | model id | Notes |
|---|
Passer d'un modèle à l'autre au sein d'un même type se résume à changer le model id. Le chat et le raisonnement partagent un endpoint ; les images et la vidéo ont le leur — les extraits de code ci-dessus s'adaptent automatiquement au modèle que tu choisis.
Configuration manuelle
N'importe quel client qui parle le protocole OpenAI peut se connecter à Octer avec ces quatre valeurs.
Autres usages
Les deux autres parcours sont regroupés ici — la même clé fonctionne partout ; dépliez-les quand vous en avez besoin.
Dépannage
À propos de tes données : tes prompts et images de référence sont envoyés à la passerelle Octer pour produire le résultat ; ta clé API ne circule que dans l'en-tête de la requête et n'est jamais écrite sur disque ; les images et vidéos générées restent sur ta machine.