Guía

Lleva los modelos de Octer a tu agente y a tu código

Una sola API key: apunta tu agente local (OpenClaw / Hermes) a los modelos de Octer, o llama a la API directamente para chat, imágenes y video.

¿Qué quieres hacer?

¿No sabes cuál elegir? La mayoría elige la tarjeta del medio: deja que tu agente genere imágenes y video directamente en el chat; es la forma más rápida de empezar. Puedes cambiar cuando quieras.

AgenteSistemaModelo
1

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 →

Al pegarla, todos los comandos de esta página usan tu clave real: cópialos y ejecútalos tal cual. La clave se queda solo en esta página — nunca se envía ni se guarda; al recargar o cerrar la pestaña desaparece.

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):

Sistema

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.

2

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.

AgenteSistema

Paso 1 · Instala el cliente

Comprueba que la CLI está disponible:

Paso 2 · Cámbialo a un modelo de Octer

Modelo

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.

3

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 en videos/.
  • 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 status para 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.
4

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.

Endpointhttps://oclaw.octer.ai/v1
AutenticaciónAuthorization: Bearer sk-YOUR_KEY
TareaModelo
💻 Código de ejemplo

5

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.

TipoModelomodel idNotas

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.

6

Configuración manual

Cualquier cliente que hable el protocolo de OpenAI puede conectarse a Octer con estos cuatro valores.

Endpointhttps://oclaw.octer.ai/v1
ProtocoloCompatible con OpenAI
API Keysk-YOUR_KEY
Modelogemini-3-flash-preview
7

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.

Únete y recibe Free Credits 🎁

Únete a nuestras comunidades oficiales para acceso anticipado a modelos, eventos y créditos gratis.

DiscordComunidad global de desarrolladoresWhatsAppGrupo de usuariosMás comunidades · próximamente