Escolha a integração
O mesmo endpoint e a mesma API key funcionam em qualquer cliente compatível. Para o Codex CLI, use o protocolo Responses; para outros aplicativos, escolha OpenAI-compatible.
Pré-requisitos
- Sua API key individual, recebida do administrador.
- Para o Codex CLI: Node.js com npm, ou o instalador para macOS/Linux.
- Um terminal: PowerShell no Windows ou Terminal no macOS/Linux.
Não envie a chave por mensagem nem salve em repositórios. Se houver suspeita de exposição, solicite a revogação imediatamente.
Instalar e configurar — Codex CLI
Instale o Codex
Com npm, em Windows, macOS ou Linux:
npm install -g @openai/codexAlternativa oficial para macOS/Linux:
curl -fsSL https://chatgpt.com/codex/install.sh | shSalve sua API key
[System.Environment]::SetEnvironmentVariable("MANUS_API_KEY", "SUA_API_KEY", "User")export MANUS_API_KEY="SUA_API_KEY"Crie o arquivo de configuração
Edite ~/.codex/config.toml. No Windows, ele fica em %USERPROFILE%\.codex\config.toml.
model = "gpt-5.6-sol"
model_provider = "manus"
[model_providers.manus]
name = "Manus API"
base_url = "https://api-codex.manus.api.br/v1"
env_key = "MANUS_API_KEY"
wire_api = "responses"A chave é carregada pela variável MANUS_API_KEY e não fica gravada no arquivo TOML.
Aplicativos OpenAI-compatible
MANUS CODEXOpenAI-compatiblehttps://api-codex.manus.api.br/v1chat/completionsembeddingssua chave sk-manus-…Modelos em destaque
Os três perfis GPT-5.6 abaixo foram verificados diretamente no gateway e funcionam com Responses API, Chat Completions e Codex CLI.
SOL
gpt-5.6-solPara programação complexa, arquitetura, revisão e tarefas que exigem a melhor qualidade.
TERRA
gpt-5.6-terraEquilíbrio entre capacidade, velocidade e custo para o trabalho cotidiano.
LUA
gpt-5.6-lunaIndicado para alto volume, respostas rápidas, automações e tarefas objetivas.
Outros modelos liberados
fable-5gpt-5.5gpt-5.5-proGPT-5.6HaikuSonnetOpus 4.7Opus 4.8Opus 5TokenRouterPara integrações novas, recomendamos começar com gpt-5.6-sol. Use TERRA para equilibrar desempenho e custo, ou LUA para volume e velocidade.
Modelos para criação de imagens
Disponíveis na busca de modelos da própria API (GET /v1/models) e usados em POST /v1/images/generations com a mesma API key.
fluxFLUX.1 SchnellRápido · padrão de 2 passos · até 1024 × 1024sdxlStable Diffusion XL BaseQualidade · use pelo menos 8 passos · recomendado em 512 × 512sdxl-lightningStable Diffusion XL LightningRecomendado para velocidade · 4 passos · 512 × 512img_gpt_proChatGPT Imagem ProTexto para imagem e imagem para imagem · aceita proporção e até 3 referênciasimg_gpt_pro gera imagens somente a partir do prompt (texto para imagem) ou combina o prompt com referências (imagem para imagem).
Para imagem para imagem, envie referências opcionais em base64:
"reference_images": [
"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD..."
]Verificar conexão
Teste primeiro a autenticação e a lista de modelos:
curl https://api-codex.manus.api.br/v1/models \
-H "Authorization: Bearer SUA_API_KEY"Para testar uma resposta OpenAI-compatible:
curl https://api-codex.manus.api.br/v1/chat/completions \
-H "Authorization: Bearer SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Olá"}]}'Se usar o Codex CLI, feche e abra o terminal após salvar a variável e execute:
codexSolução de problemas
Erro 401 — API key inválida
Confirme se copiou a chave inteira, sem espaços, e se ela ainda está ativa. A chave começa com sk-manus-.
Erro 429 — limite excedido
Aguarde um minuto e tente novamente. O limite individual é definido pelo administrador.
Comando codex não encontrado
Abra um novo terminal após instalar. Se persistir, confirme a instalação com npm list -g @openai/codex.
Codex não encontra a chave
Confirme a variável com $env:MANUS_API_KEY no PowerShell ou echo $MANUS_API_KEY no macOS/Linux.
FAQ rápida
Posso usar a mesma chave em vários dispositivos?
Sim, mas não compartilhe com outras pessoas. O uso conta no mesmo limite.
Qual modelo devo escolher?
Comece com gpt-5.6-sol. Para velocidade e volume, escolha LUA.
Preciso usar uma chave OpenAI?
Não. Use somente a chave Manus fornecida pelo administrador.
Minha chave aparece no painel?
A chave completa aparece apenas na criação. Depois, o painel mostra somente o prefixo.