Guia

Traga os modelos da Octer para o seu agente e para o seu código

Uma única API key: aponte seu agente local (OpenClaw / Hermes) para os modelos da Octer ou chame a API direto para chat, imagens e video.

O que você quer fazer?

Na dúvida? A maioria escolhe o cartão do meio — deixe seu agente gerar imagens e video direto no chat; é o jeito mais rápido de começar. Dá para trocar a qualquer momento.

AgenteSistemaModelo
1

Antes de começar: pegue sua API key

Tudo o que vem a seguir — o agente, imagens, video, chamadas diretas à API — usa essa mesma key.

  • Abra o console da Octer: octer.ai/workspace/o/ → (sem conta? registre-se primeiro)
  • Na página OClaw, clique em copiar para obter uma key que começa com sk-.

🎁 Novos usuários ganham créditos de teste ao se registrar — pegue sua key e experimente tudo de graça antes de gastar qualquer coisa. Registre-se e ganhe créditos →

Depois de colar, todos os comandos desta página passam a usar sua chave real — é só copiar e rodar. A chave fica somente nesta página: nunca é enviada nem armazenada; recarregar ou fechar a aba a apaga.

Reserve um segundo para conferir se a key funciona (escolha primeiro o seu sistema e copie — uma resposta em JSON significa que a key e sua rede estão OK):

Sistema

Troque o sk-YOUR_KEY de todos os comandos abaixo pela sua própria key.

Não voltou JSON, ou deu 401 / 403? A "Solução de problemas →" tem a saída para cada caso.

2

Conecte seu agente

OpenClaw e Hermes são assistentes de IA locais, gratuitos e de código aberto — rodam no seu próprio computador e você conversa com eles no terminal. Nunca instalou? O passo 1 abaixo guia você do zero.

Escolha seu agente e seu sistema — todos os comandos abaixo se ajustam automaticamente.

AgenteSistema

Passo 1 · Instale o cliente

Confira se a CLI está disponível:

Passo 2 · Mude para um modelo da Octer

Modelo

O script grava o endpoint, a key e o modelo, reinicia o gateway e envia um “olá” de teste — se a resposta vier normal, está tudo pronto.

Passo 3 · Verifique

Rode estes dois, um depois do outro:

Mudou de ideia? Desfaça

Este comando limpa a configuração de modelo da Octer e mantém o resto do seu setup intacto.

3

Imagens e video

O passo acima cobre só o chat. Para que seu agente também gere imagens e video, instale a skill oclaw — uma CLI enxuta que reúne as três capacidades e salva o que for gerado direto na sua máquina.

O jeito mais fácil: cole esta frase no chat do OpenClaw / Hermes e o próprio agente faz a instalação.

Ainda não tem OpenClaw / Hermes? Veja "Conecte seu agente →" — dois comandos e pronto. Sem agente? Use o método de terminal abaixo.

Coloque a sua própria key. Depois disso, é só pedir em linguagem natural: “gere uma imagem de…” ou “faça um video de…” — o agente cuida do resto.

Você também pode usar direto no terminal (sem dependências além do Python 3):

No Windows: esta ferramenta é um script bash — rode no WSL ou no Git Bash (não roda direto no PowerShell).

  • As imagens vão para images/ e os videos para videos/.
  • Video é assíncrono: costuma levar de 1 a 3 minutos, e a CLI aguarda e baixa por você. Se der timeout, nada é perdido — a tarefa continua rodando. Rode ./oclaw.sh status para achar o id da tarefa e depois ./oclaw.sh watch <task-id>.
  • Os links de video expiram em cerca de 24 horas, então baixe assim que a tarefa terminar. A CLI já faz isso — se você chamar a API por conta própria, não guarde só a URL.
4

Chamar a API direto

Sem agente: para integrar a Octer ao seu próprio programa, basta chamar a API HTTP. O gateway fala o protocolo OpenAI, então um SDK oficial funciona só trocando a base_url.

Endpointhttps://oclaw.octer.ai/v1
AutenticaçãoAuthorization: Bearer sk-YOUR_KEY
TarefaModelo
💻 Código de exemplo

5

Modelos

O model id é o que vai na chamada de API ou na configuração do agente — é a string destacada na tabela; o botão ao lado copia com um clique.

TipoModelomodel idNotas

Trocar entre modelos do mesmo tipo é só usar outro model id. Chat e raciocínio compartilham um endpoint; imagens e video têm os seus — os trechos de código acima se ajustam sozinhos ao modelo que você escolher.

6

Configuração manual

Qualquer cliente que fale o protocolo OpenAI chega à Octer com estes quatro valores.

Endpointhttps://oclaw.octer.ai/v1
ProtocoloCompatível com OpenAI
API Keysk-YOUR_KEY
Modelogemini-3-flash-preview
7

Solução de problemas

Sobre seus dados: os prompts e as imagens de referência são enviados ao gateway da Octer para gerar o resultado; sua API key só trafega no header da requisição e nunca é gravada em disco; as imagens e os videos gerados ficam na sua máquina.

Participe e ganhe Free Credits 🎁

Participe das nossas comunidades oficiais para acesso antecipado a modelos, eventos e créditos grátis.

DiscordComunidade global de devsWhatsAppGrupo de usuáriosMais comunidades · em breve