Tutorial de uso

Com um único token, você pode usar os modelos Claude, GPT, DeepSeek e GLM, além da geração de vídeo MiniMax-H3. Compatível com Claude Code, Codex e todos os clientes no formato OpenAI.

Início rápido

1. Cadastre-se e faça login, adicione créditos em “Carteira”.
2. Abrir Chaves de API página e clique em Criar chave de API, preencha o nome e selecione um grupo (veja a próxima seção).
3. Copie a sk- chave que começa com, e preencha conforme as instruções da ferramenta correspondente abaixo.

Selecionar grupo

Ao criar uma chave, é necessário selecionar um grupo. O grupo determina quais modelos essa chave pode chamar:

O multiplicador de cada grupo é o exibido ao criar a chave. Veja os preços por modelo em Modelos e preços。

Claude Code

Use claude-max(ou default) para o grupo da chave. A maneira mais rápida é iniciar diretamente com um único comando:

ANTHROPIC_AUTH_TOKEN="sk-你的密钥" \
ANTHROPIC_BASE_URL="https://aixvaro.com" \
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 \
claude

$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
$env:ANTHROPIC_BASE_URL="https://aixvaro.com"
$env:CLAUDE_CODE_DISABLE_1M_CONTEXT=1
claude

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aixvaro.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
  }
}

CLAUDE_CODE_DISABLE_1M_CONTEXT=1 Para que Claude Code use o contexto padrão e evitar o custo adicional do contexto longo de 1 milhão de tokens, ativado por padrão, recomendamos manter esta configuração.

Claude Code usa Opus por padrão (o mais avançado e também o mais caro). Para economizar no dia a dia, digite no Claude Code /model para mudar para Sonnet, ou use ANTHROPIC_MODEL para definir o modelo padrão, por exemplo, claude-sonnet-5。

Codex (CLI / extensão do VS Code / app para desktop)

A CLI do Codex, o plugin do Codex para VS Code / Cursor e o app para desktop do Codex usam a mesma configuração:~/.codex/config.toml(provedor) e ~/.codex/auth.json(chave). As duas etapas abaixo só precisam ser feitas uma vez para usar as três opções, sem configurar variáveis de ambiente. Use a chave do grupo gpt-codex-pro(ou default.

mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "gpt-6-sol"
model_provider = "aixvaro"

[model_providers.aixvaro]
name = "aixvaro"
base_url = "https://aixvaro.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

cat > ~/.codex/auth.json << 'EOF'
{"auth_mode": "apikey", "OPENAI_API_KEY": "sk-你的密钥"}
EOF

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
@'
model = "gpt-6-sol"
model_provider = "aixvaro"

[model_providers.aixvaro]
name = "aixvaro"
base_url = "https://aixvaro.com/v1"
wire_api = "responses"
requires_openai_auth = true
'@ | Set-Content -Encoding utf8 "$HOME\.codex\config.toml"

[IO.File]::WriteAllText("$HOME\.codex\auth.json", '{"auth_mode": "apikey", "OPENAI_API_KEY": "sk-你的密钥"}')

Depois de configurar, abra o Codex da forma que preferir:

O modelo padrão é gpt-6-sol. Para trocar de modelo, edite config.toml em model(por exemplo, gpt-6-astra、gpt-6-luna、gpt-5.6-sol). Também é possível usar diretamente codex -m gpt-6-astra。

CC Switch (alternância de provedores com um clique)

CC Switch é um pequeno app gratuito para desktop que permite alternar com um clique entre provedores para Claude Code, Codex, Gemini CLI e outros. Depois de configurá-lo, basta clicar nele para mudar o Claude Code / Codex para este site, sem precisar editar os arquivos de configuração manualmente.Use a versão mais recente (4.0 ou superior), pois versões antigas não geram automaticamente o catálogo de modelos do Codex, e os modelos não aparecerão no menu do app para desktop.

Opção 1: importar do nosso site com um clique (recomendado)

1. Instale o CC Switch no computador e abra-o pelo menos uma vez (assim, o sistema reconhecerá os links de importação com um clique).
2. Abrir Chaves de API Na página, clique em ⇄ Importar para o CC Switch à direita da linha da chave que você quer usar.
3. Na janela, selecione o app (Claude ou Codex). Os modelos serão preenchidos automaticamente com base no grupo da chave. Clique em “Abrir CC Switch”.
4. Quando o navegador perguntar se você quer abrir o CC Switch, clique em Permitir. Em seguida, clique em Importar na caixa de confirmação do CC Switch.

Opção 2: adicionar manualmente no CC Switch

Se a importação com um clique não for conveniente, você também pode adicionar manualmente nosso provedor no CC Switch:

1. Abra o CC Switch e selecione na barra lateral esquerda Claude Code ou Codex. Clique em “Adicionar provedor” no canto superior direito e selecione “Configuração personalizada”.
2. Escolha qualquer nome (por exemplo, aixvaro）；API Key ) e insira sua sk- chave; emURL da solicitação da API, insira o endereço correspondente na tabela abaixo.
3. Clique em “Obter lista de modelos” para buscar automaticamente os modelos do grupo da chave. Selecione todos e clique em “Aplicar”. Se houver modelos padrão desnecessários na lista (como gpt-5.6-sol), exclua a linha correspondente.
4. Clique em “Adicionar” para salvar e, em seguida, clique em ▶ na linha do provedor para alternar para ele.

Cliente de chat

Você pode usar qualquer cliente compatível com “API compatível com OpenAI”, como Cherry Studio, ChatBox, LobeChat e NextChat:

Na Chaves de API página, você também pode clicar no botão “Chat” para importar com um clique para clientes como o Cherry Studio.

Claude API (formato nativo da Anthropic)

Use o SDK oficial da Anthropic ou a Messages API; basta alterar base_url e a chave. O endereço é https://aixvaro.com(sem /v1).

import anthropic

client = anthropic.Anthropic(
    api_key="sk-你的密钥",
    base_url="https://aixvaro.com"
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
# 返回内容可能包含 thinking（思考）块，只取文字部分
print("".join(b.text for b in message.content if b.type == "text"))

curl https://aixvaro.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

curl https://aixvaro.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

curl https://aixvaro.com/v1/models \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01"

A autenticação usa x-api-key o cabeçalho de solicitação (igual ao da API oficial da Anthropic) e exige também o anthropic-version cabeçalho de solicitação.

Chamadas no formato OpenAI

Os modelos Claude e GPT também podem ser chamados pela interface compatível com OpenAI https://aixvaro.com/v1 usando autenticação Authorization: Bearer .

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://aixvaro.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-5",   # GPT 模型同样可用，例如 gpt-6-sol
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

curl https://aixvaro.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

DeepSeek / GLM

Use deepseek、glm(ou default)). O endereço é o mesmo acima. Há suporte para três formatos de chamada:

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://aixvaro.com/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",   # 或 glm-5.3、deepseek-v4-pro 等
    messages=[{"role": "user", "content": "你好！"}],
    max_tokens=2048
)
print(response.choices[0].message.content)

curl https://aixvaro.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "max_tokens": 2048,
    "messages": [{"role": "user", "content": "你好！"}]
  }'

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aixvaro.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
  }
}

model = "deepseek-v4-pro"
model_provider = "aixvaro"

[model_providers.aixvaro]
name = "aixvaro"
base_url = "https://aixvaro.com/v1"
wire_api = "responses"
requires_openai_auth = true

Lista de modelos

Ao fazer chamadas, model preencha com o ID da tabela abaixo. Consulte os preços unitários em tempo real em Modelos e preços。

Perguntas frequentes