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 →
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):
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.
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.
Passo 1 · Instale o cliente
Confira se a CLI está disponível:
Passo 2 · Mude para um modelo da Octer
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.
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 paravideos/. - 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 statuspara 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.
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.
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.
| Tipo | Modelo | model id | Notas |
|---|
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.
Configuração manual
Qualquer cliente que fale o protocolo OpenAI chega à Octer com estes quatro valores.
Outros usos
Os outros dois caminhos ficam aqui — a mesma chave funciona para todos; expanda quando precisar.
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.