Antes de empezar: consigue tu API key
Todo lo que viene a continuación —el agente, las imágenes, el video, las llamadas directas a la API— usa esta misma key.
- Abre la consola de Octer: octer.ai/workspace/o/ → (si no tienes cuenta, regístrate primero)
- En la página de OClaw, pulsa copiar para obtener una key que empieza por
sk-.
🎁 Los usuarios nuevos reciben créditos de prueba al registrarse: consigue tu key y pruébalo todo gratis antes de gastar nada. Regístrate y recibe créditos →
Dedica un segundo a comprobar que la key funciona (elige primero tu sistema y copia: si recibes un JSON, la key y tu red están bien):
Sustituye sk-YOUR_KEY por tu propia key en todos los comandos siguientes.
¿No vuelve JSON, o da 401 / 403? En «Solución de problemas →» está la solución para cada caso.
Conecta tu agente
OpenClaw y Hermes son asistentes de IA locales, gratuitos y de código abierto: corren en tu propio ordenador y hablas con ellos desde la terminal. ¿Nunca instalaste uno? El paso 1 te guía desde cero.
Elige tu agente y tu sistema operativo: todos los comandos de abajo se adaptan solos.
Paso 1 · Instala el cliente
Comprueba que la CLI está disponible:
Paso 2 · Cámbialo a un modelo de Octer
El script escribe el endpoint, la key y el modelo, reinicia el gateway y envía un «hola» de prueba: si responde con normalidad, ya está listo.
Paso 3 · Verifica
Ejecuta estos dos comandos, uno tras otro:
¿Cambiaste de idea? Deshazlo
Esto borra la configuración de modelos de Octer y deja intacto el resto de tus ajustes.
Imágenes y video
El paso anterior solo cubre el chat. Para que tu agente también genere imágenes y video, añade la skill oclaw: una pequeña CLI que envuelve las tres capacidades y guarda lo que genera directamente en tu máquina.
La forma fácil: pega esto en el chat de OpenClaw / Hermes y el agente se la instalará solo.
¿Aún no tienes OpenClaw / Hermes? Mira «Conecta tu agente →»: dos comandos y listo. ¿Sin agente? Usa el método de terminal de abajo.
Pon tu propia key. Después basta con decir «genérame una imagen de…» o «haz un video de…» en lenguaje natural: el agente se encarga del resto.
También puedes usarla desde la terminal (sin más dependencias que Python 3):
En Windows: esta herramienta es un script bash; ejecútala en WSL o Git Bash (no funciona directamente en PowerShell).
- Las imágenes se guardan en
images/y los videos envideos/. - El video es asíncrono: suele tardar entre 1 y 3 minutos, y la CLI espera y descarga por ti. Si se agota el tiempo, no se pierde nada: la tarea sigue en marcha. Ejecuta
./oclaw.sh statuspara localizar el task id y luego./oclaw.sh watch <task-id>. - Los enlaces de video caducan en unas 24 horas, así que descárgalos en cuanto termine la tarea. La CLI ya lo hace; si llamas a la API tú mismo, no guardes solo la URL.
Llama a la API directamente
No hace falta ningún agente: para integrar Octer en tu propio programa, basta con llamar a la API HTTP. El gateway habla el protocolo de OpenAI, así que cualquier SDK oficial funciona con solo cambiar la base_url.
Modelos
El model id es lo que va en una llamada a la API o en la configuración del agente: es la cadena resaltada de la tabla; el botón de al lado la copia con un clic.
| Tipo | Modelo | model id | Notas |
|---|
Cambiar entre modelos del mismo tipo es solo cuestión de usar otro model id. Chat y razonamiento comparten un endpoint; imágenes y video tienen el suyo propio, y los fragmentos de arriba se adaptan solos al modelo que elijas.
Configuración manual
Cualquier cliente que hable el protocolo de OpenAI puede conectarse a Octer con estos cuatro valores.
Otros usos
Los otros dos caminos están aquí: la misma clave sirve para todos; despliégalos cuando los necesites.
Solución de problemas
Sobre tus datos: los prompts y las imágenes de referencia se envían al gateway de Octer para generar el resultado; tu API key solo viaja en la cabecera de la petición y nunca se escribe en disco; las imágenes y los videos generados se quedan en tu máquina.