Gateway operacional

Configure sua ferramenta de IA
com a Manus API

Use sua chave individual para conectar Codex CLI, aplicativos OpenAI-compatible e automações ao gateway Codex.

API BASE URLhttps://api-codex.manus.api.br/v1
01

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.

Codex CLITerminal e projetos locais
OpenAI-compatibleAplicativos, SDKs e automações
02

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.
Proteja sua chave

Não envie a chave por mensagem nem salve em repositórios. Se houver suspeita de exposição, solicite a revogação imediatamente.

03

Instalar e configurar — Codex CLI

Instale o Codex

Com npm, em Windows, macOS ou Linux:

npm install -g @openai/codex

Alternativa oficial para macOS/Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Salve sua API key

Windows PowerShell
[System.Environment]::SetEnvironmentVariable("MANUS_API_KEY", "SUA_API_KEY", "User")
macOS / Linux
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

NomeMANUS CODEX
TipoOpenAI-compatible
API Base URLhttps://api-codex.manus.api.br/v1
Chatchat/completions
Embeddingsembeddings
API Keysua chave sk-manus-…
04

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.

Outros modelos liberados

fable-5gpt-5.5gpt-5.5-proGPT-5.6HaikuSonnetOpus 4.7Opus 4.8Opus 5TokenRouter

Para 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 × 1024
sdxlStable Diffusion XL BaseQualidade · use pelo menos 8 passos · recomendado em 512 × 512
sdxl-lightningStable Diffusion XL LightningRecomendado para velocidade · 4 passos · 512 × 512
img_gpt_proChatGPT Imagem ProTexto para imagem e imagem para imagem · aceita proporção e até 3 referências

img_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..."
]
05

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:

codex
06

Soluçã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.

07

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.