Aviso: Kling 4.0 chegou: geração de vídeo a partir de texto e de imagem com 20% de desconto por tempo limitado, experimente agora
HiAPI
Tutoriais

Configuração por API Key

Gere uma configuração para Claude Code, Codex, OpenCode ou Hermes, ou importe-a para o CC Switch num clique.

Escolha a sua ferramenta de IA

Usar com
Sistema

Configuração local do Codex

DeepSeek V4 Flash Vision Exp · Linha de comando · macOS

Importar para o CC Switch

Escolha a ferramenta, o modelo e a API Key a importar.

API Key

A carregar…

A Key escolhida será entregue ao seu CC Switch local; confirme a importação no cliente antes de mudar.

Responses API · https://api.hiapi.ai/v1

Não abriu? Instale ou atualize o CC Switch e tente novamente, ou continue com a configuração manual.

Antes de começarCodex CLI 0.134+ · Modo linha de comando: confirme primeiro a versão do Codex CLI num terminal.codex --versionGuia de instalação ↗

1Guardar o ficheiro de configuração

Crie hiapi.config.toml na pasta .codex do seu diretório pessoal, cole a configuração abaixo e guarde. Crie a pasta se não existir.

Guardar em~/.codex/hiapi.config.toml

~ significa o seu diretório pessoal; .codex é uma pasta oculta dentro dele.

Cole no ficheiro de configuração
model_provider = "hiapi"
model = "deepseek-v4-flash-vision-exp"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

Já tem este ficheiro?

Deixe config.toml como está. Se hiapi.config.toml já existir, atualize o model, o model_provider e os campos de [model_providers.hiapi]. Mantenha as outras definições; não duplique chaves nem tabelas.

2Definir a API Key no terminal

Abra um terminal (bash / zsh), substitua YOUR_HIAPI_API_KEY pela sua chave e execute o comando abaixo. Não coloque este comando no ficheiro de configuração. Gerir API Keys ↗

Copiar comando
export HIAPI_API_KEY="YOUR_HIAPI_API_KEY"

3Arrancar o agente no mesmo terminal

No terminal onde definiu a chave, entre no diretório do seu projeto e execute o comando abaixo. Ele carrega hiapi.config.toml e mantém a sua configuração predefinida. Ao abrir um novo terminal, defina a chave novamente. Depois de arrancar o agente, envie uma mensagem e verifique o registo de pedidos.

Comando de arranque
codex --profile hiapi

4Confirme a ligação com uma mensagem

Depois de arrancar, envie isto na mesma conversa do agente:

Responde apenas com HIAPI_OK. Não leias nem alteres ficheiros.

Depois de receber o texto, confirme o modelo e o estado no registo de pedidos; copiar este prompt não prova que a ligação funciona. Ver registo de pedidos ↗

Sem resposta?

Verifique primeiro a API Key, o registo de pedidos, o modelo e a versão do CLI. Os modelos de raciocínio podem demorar mais; não defina um limite de saída muito baixo, não force a desativação do raciocínio nem altere a configuração existente.

Protocolo: Responses APIGuia oficial de configuração ↗