Primeros pasos

Usar en una app

Usa tu clave en las apps que ya tienes, sin escribir código. Elige la app, copia su configuración y listo. Estos pasos son para modelos GPT.

#1. Elige tu app

Apps de chat y traducción

Herramientas de programación

Tu propio código

#2. Copia la configuración

Cherry Studio

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

API Key

API Host

Modelo

"API Host" añade /v1/chat/completions automáticamente. Termina la URL en el host (o en /v1); añade # para desactivar el añadido automático.

Mantén privada tu clave de API

Guarda la clave en una variable de entorno o un gestor de secretos. Nunca pegues una clave permanente en código del navegador, en capturas de pantalla ni en un repositorio.

#3. Comprueba que funciona

  1. Elige el modelo en la app y envía un mensaje corto, como “hola”.
  2. Si recibes una respuesta, estás conectado. La llamada aparece en Consola → Uso.
  3. Si la app rechaza la clave, comprueba si espera la dirección con /v1 o sin él.

#Herramientas MCP

La conexión del modelo y MCP son independientes

aisplice proporciona la conexión con los modelos. Los servidores MCP proporcionan herramientas y datos externos. Configura el proveedor aisplice y cada servidor MCP por separado dentro de Codex, Cursor u otro cliente.

En Codex, añade un servidor MCP remoto con la CLI o coloca el bloque equivalente en ~/.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"

La autenticación de MCP es independiente

Tu clave de API de aisplice solo autentica las solicitudes a modelos. Sigue las instrucciones del proveedor del servidor MCP para OAuth, encabezados o variables de entorno, y luego reinicia el cliente para que recargue la configuración.

#Migrar desde el SDK de OpenAI

#El diff de dos líneas

En la mayoría de los proyectos, este es todo el PR. Como el formato de la API es compatible con OpenAI, el streaming, las llamadas a herramientas, la visión y las salidas estructuradas siguen funcionando con el código que ya tienes.

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,
});

¿Sigues con el problema?

Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.