Primeiros passos

Usar em um app

Use sua chave nos apps que você já tem, sem escrever código. Escolha o app, copie as configurações e pronto. Estes passos são para modelos GPT.

#1. Escolha o seu app

Apps de chat e tradução

Ferramentas de código

Seu próprio código

#2. Copie as configurações

Cherry Studio

Abra: Settings (设置) → Model Providers (模型服务) → OpenAI

API Key

API Host

Modelo

"API Host" adiciona /v1/chat/completions automaticamente. Termine a URL no host (ou em /v1); coloque # no final para desativar esse acréscimo.

Mantenha sua chave de API privada

Armazene a chave em uma variável de ambiente ou em um gerenciador de segredos. Nunca cole uma chave permanente em código de navegador, capturas de tela ou em um repositório.

#3. Confira se funciona

  1. Escolha o modelo no app e envie uma mensagem curta, como “olá”.
  2. Se vier uma resposta, você está conectado. A chamada aparece em Console → Uso.
  3. Se o app rejeitar a chave, verifique se ele espera o endereço com ou sem /v1.

#Ferramentas MCP

A conexão com o modelo e o MCP são separados

O aisplice fornece a conexão com o modelo. Os servidores MCP fornecem ferramentas e dados externos. Configure o provedor aisplice e cada servidor MCP separadamente no Codex, no Cursor ou no seu outro cliente.

No Codex, adicione um servidor MCP remoto pela CLI ou coloque o bloco equivalente em ~/.codex/config.toml:

Codex MCP
# CLI
codex mcp add my-tools --url https://mcp.example.com/mcp

# equivalent ~/.codex/config.toml
[mcp_servers.my-tools]
url = "https://mcp.example.com/mcp"

A autenticação do MCP é separada

Sua chave de API do aisplice autentica apenas requisições de modelo. Siga as instruções do provedor do servidor MCP para OAuth, cabeçalhos ou variáveis de ambiente e depois reinicie o cliente para que ele recarregue a configuração.

#Migrando do SDK da OpenAI

#O diff de duas linhas

Na maioria dos códigos, este é o PR inteiro. Como o formato da API é compatível com OpenAI, streaming, chamada de ferramentas, visão e saídas estruturadas continuam funcionando com o código que você já tem.

const client = new OpenAI({
- baseURL: "https://api.openai.com/v1",
+ baseURL: "https://www.aisplice.store/v1",
- apiKey: process.env.OPENAI_API_KEY,
+ apiKey: process.env.GATEWAY_API_KEY,
});

Ainda com problemas?

Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.