> ## Documentation Index > Fetch the complete documentation index at: https://docs.moxus.ai/llms.txt > Use this file to discover all available pages before exploring further. # Inicio rápido > Cree una clave API y llame a Moxus AI desde código externo, SDK, scripts o herramientas externas. Esta página explica cómo llamar a Moxus AI desde fuera de la aplicación web con una clave API que usted crea, como desde código del lado del servidor, cURL, SDK o herramientas externas. La conversación es una superficie de prueba web. Después de iniciar sesión, utiliza una clave virtual interna automáticamente. No es necesario que pegue su clave API recién creada en Conversación. La clave `sk-` que crea es para código externo, SDK, scripts y herramientas externas. ## Flujo Vaya a `https://moxus.ai` e inicie sesión con su correo electrónico o con un proveedor de inicio de sesión externo habilitado. Abra Facturación y confirme que su cuenta tenga saldo utilizable de recarga, un código de canje o una concesión de plataforma. Abra Claves API y cree una clave que comience con `sk-`. Esta clave es para código externo, SDK, scripts y herramientas externas, no es una configuración de conversación requerida. Abra Model Square, copie el nombre exacto del modelo y elija la URL base correspondiente y el formato de solicitud para su protocolo. Envíe la solicitud con cURL o el SDK que coincida con su protocolo. La mayoría de los proyectos pueden comenzar con OpenAI SDK. Las claves API solo se muestran completas cuando se crean. Copie la clave inmediatamente y nunca la envíe al código de interfaz, repositorios públicos, capturas de pantalla o mensajes de chat compartidos. ## Elija un estilo de solicitud Cada protocolo tiene su propia URL base, método de autenticación y cuerpo de solicitud. No envíe un cuerpo de solicitud OpenAI a los puntos finales nativos de Anthropic o Google. | Solicitar estilo | URL básica | Autenticación | Lo mejor para | | --------------------- | ------------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | Compatible con OpenAI | `https://moxus.ai/v1` | `Authorization: Bearer sk-your-key` | OpenAI SDK, finalización de chat, imágenes, la mayoría de las herramientas externas | | Compatible antrópico | `https://moxus.ai` | `x-api-key: sk-your-key` | API de mensajes nativa de Claude o SDK de Anthropic | | Compatible con Google | `https://moxus.ai/v1beta` | Parámetro de consulta `?key=sk-your-key` o configuración específica del cliente | API nativa de Google o clientes compatibles con Google | ## Sin SDK: HTTP directo Para verificar que su clave, modelo y punto final funcionan, puede enviar una solicitud HTTP simple sin instalar un SDK de AI. Elija el ejemplo que coincida con su protocolo: las llamadas OpenAI, Anthropic y compatibles con Google utilizan diferentes URL, métodos de autenticación y cuerpos de solicitud. Cada ejemplo coloca la clave directamente en el código, por lo que no se requiere configuración de terminal o entorno de archivo de configuración. Reemplace `sk-your-key` en el ejemplo seleccionado con su clave real. Las llamadas compatibles con OpenAI son la ruta más común para las migraciones de chat, herramientas y SDK. Utilice `https://moxus.ai/v1/chat/completions` con `Authorization: Bearer ...`. ```bash cURL theme={null} curl https://moxus.ai/v1/chat/completions \ -H "Authorization: Bearer sk-your-key" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.4-mini", "messages": [{"role": "user", "content": "Say hello in one sentence"}] }' ``` Las llamadas compatibles con Anthropic son para mensajes nativos de Claude. Utilice `https://moxus.ai/v1/messages` con el encabezado `x-api-key` y un encabezado `anthropic-version`. ```bash cURL theme={null} curl https://moxus.ai/v1/messages \ -H "x-api-key: sk-your-key" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-4-6", "max_tokens": 512, "messages": [{"role": "user", "content": "Say hello in one sentence"}] }' ``` Las llamadas compatibles con Google son para formularios de solicitud `generateContent` nativos de Google. Utilice `https://moxus.ai/v1beta` y pase la clave en el parámetro de consulta `key`. ```bash cURL theme={null} curl "https://moxus.ai/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-key" \ -H "Content-Type: application/json" \ -d '{ "contents": [ { "parts": [ {"text": "Say hello in one sentence"} ] } ] }' ``` ## Configuración del SDK Los SDK ensamblan la solicitud HTTP por usted. Al conectar un SDK a Moxus AI, confirme tres configuraciones: | Configuración | Valor | | ----------------- | ---------------------------------------------------------------------------------------- | | Clave API | La clave `sk-` creada en Claves API | | URL básica | `https://moxus.ai/v1`, `https://moxus.ai` o `https://moxus.ai/v1beta` según el protocolo | | Nombre del modelo | El nombre exacto del modelo copiado de Model Square | Para una primera llamada, comience con el SDK de OpenAI. Utilice el SDK de Anthropic o el SDK de Google cuando su proyecto espere específicamente mensajes nativos de Claude o formatos de solicitud nativos de Google. Para facilitar la primera llamada, los ejemplos colocan la clave directamente en una variable `API_KEY`. Después de copiar, reemplace solo `sk-your-key` y ejecute el archivo. No envíe un archivo que contenga una clave real a un repositorio público ni lo comparta. Para producción, mueva la clave a las variables de entorno o a la gestión de secretos del lado del servidor. Para instalación de dependencia, elija `npm` o `pnpm`; son alternativas. ## SDK de OpenAI Si no está seguro de qué estilo utilizar, comience con la API compatible con OpenAI. Funciona para la mayoría de llamadas de modelos, SDK y herramientas externas. Instalar dependencias: ```bash npm theme={null} npm install openai tsx ``` ```bash pnpm theme={null} pnpm add openai tsx ``` Copie el código siguiente en `openai_example.py` para Python o `openai-example.ts` para TypeScript. ```python Python theme={null} from openai import OpenAI API_KEY = "sk-your-key" client = OpenAI( api_key=API_KEY, base_url="https://moxus.ai/v1", ) response = client.chat.completions.create( model="gpt-5.4-mini", messages=[{"role": "user", "content": "Say hello in one sentence"}], ) print(response.choices[0].message.content) ``` ```typescript TypeScript theme={null} import OpenAI from "openai"; const API_KEY = "sk-your-key"; const client = new OpenAI({ apiKey: API_KEY, baseURL: "https://moxus.ai/v1", }); const response = await client.chat.completions.create({ model: "gpt-5.4-mini", messages: [{ role: "user", content: "Say hello in one sentence" }], }); console.log(response.choices[0].message.content); ``` ## SDK antrópico Utilice el SDK de Anthropic cuando su proyecto ya utilice mensajes nativos de Claude. Establezca la URL base en `https://moxus.ai`; el SDK añade `/v1/messages`. Instalar dependencias: ```bash npm theme={null} npm install @anthropic-ai/sdk tsx ``` ```bash pnpm theme={null} pnpm add @anthropic-ai/sdk tsx ``` Copie el código siguiente en `anthropic_example.py` para Python o `anthropic-example.ts` para TypeScript. ```python Python theme={null} import httpx from anthropic import Anthropic API_KEY = "sk-your-key" client = Anthropic( api_key=API_KEY, base_url="https://moxus.ai", http_client=httpx.Client( trust_env=False, timeout=60.0, ), ) message = client.messages.create( model="claude-opus-4-6", max_tokens=512, messages=[{"role": "user", "content": "Say hello in one sentence"}], ) print(message.content[0].text) ``` ```typescript TypeScript theme={null} import Anthropic from "@anthropic-ai/sdk"; const API_KEY = "sk-your-key"; const client = new Anthropic({ apiKey: API_KEY, baseURL: "https://moxus.ai", }); const message = await client.messages.create({ model: "claude-opus-4-6", max_tokens: 512, messages: [{ role: "user", content: "Say hello in one sentence" }], }); const text = message.content.find((block) => block.type === "text")?.text; console.log(text); ``` ## SDK de Google Utilice el SDK de Google GenAI cuando su proyecto espere formatos de solicitud nativos de Google. Para el SDK de Google, establezca `base_url` / `baseUrl` en `https://moxus.ai` y configure la versión de API en `v1beta`; no repita `/v1beta` en la URL base del SDK. Instalar dependencias: ```bash npm theme={null} npm install @google/genai tsx ``` ```bash pnpm theme={null} pnpm add @google/genai tsx ``` Copie el código siguiente en `google_example.py` para Python o `google-example.ts` para TypeScript. ```python Python theme={null} from google import genai from google.genai import types API_KEY = "sk-your-key" client = genai.Client( api_key=API_KEY, http_options=types.HttpOptions( api_version="v1beta", base_url="https://moxus.ai", ), ) response = client.models.generate_content( model="gemini-2.5-pro", contents="Say hello in one sentence", ) print(response.text) ``` ```typescript TypeScript theme={null} import { GoogleGenAI } from "@google/genai"; const API_KEY = "sk-your-key"; const ai = new GoogleGenAI({ apiKey: API_KEY, httpOptions: { apiVersion: "v1beta", baseUrl: "https://moxus.ai", }, }); const response = await ai.models.generateContent({ model: "gemini-2.5-pro", contents: "Say hello in one sentence", }); console.log(response.text); ``` ## Verificar la solicitud Después de que una solicitud externa tenga éxito, abra Uso y verifique los registros de actividad de API para conocer el tiempo de solicitud, la clave de API, el nombre del modelo, los tokens de entrada, los tokens de salida, los tokens totales y el costo. Las llamadas de Conversation también aparecen en los registros, pero utilizan la clave virtual interna de la plataforma. Para verificar su clave API externa, ejecute uno de los ejemplos de cURL o SDK en esta página. ## Errores comunes en la primera llamada | Error | Causa probable | Arreglar | | ------------------------------------ | --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | | `401 Unauthorized` | Clave incorrecta, encabezado de autenticación que no coincide, clave deshabilitada o clave caducada | Utilice el método de autenticación para el protocolo seleccionado | | `insufficient quota` | El saldo de la cuenta o la cuota clave están agotados | Recargar o aumentar el límite de cuota clave | | `model not found` | Nombre de modelo incorrecto, modelo no disponible o límites de modelo clave | Copie el nombre exacto del modelo de Model Square | | Error en el cuerpo de la solicitud | Se envió un cuerpo de solicitud de un protocolo a otro punto final de protocolo | Utilice el ejemplo correspondiente de OpenAI, Anthropic o Google | | Error de tiempo de espera o conexión | URL base incorrecta o problema de red | Confirme la URL base y vuelva a intentarlo | ## Próximos pasos * [Claves API](/es/platform/account-and-keys) * [Modelos y precios](/es/overview/models-and-pricing) * [Inicio rápido](/es/overview/quickstart) * [Cursor](/es/integrations/clients/cursor)