Inicio rápido

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

Iniciar sesión

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.

preparar saldo

Abra Facturación y confirme que su cuenta tenga saldo utilizable de recarga, un código de canje o una concesión de plataforma.

Crear una clave API para llamadas externas

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.

Elige un protocolo y modelo

Abra Model Square, copie el nombre exacto del modelo y elija la URL base correspondiente y el formato de solicitud para su protocolo.

Enviar una solicitud externa

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.

Compatible con OpenAI
compatible antrópico
Compatible con Google

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 ....

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.

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.

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:

npm install openai tsx

pnpm add openai tsx

Copie el código siguiente en openai_example.py para Python o openai-example.ts para TypeScript.

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)

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:

npm install @anthropic-ai/sdk tsx

pnpm add @anthropic-ai/sdk tsx

Copie el código siguiente en anthropic_example.py para Python o anthropic-example.ts para TypeScript.

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)

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:

npm install @google/genai tsx

pnpm add @google/genai tsx

Copie el código siguiente en google_example.py para Python o google-example.ts para TypeScript.

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)

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

Descripción general

Plataforma

Guías

Integraciones

Inicio rápido

Flujo

Elija un estilo de solicitud

Sin SDK: HTTP directo

Configuración del SDK

SDK de OpenAI

SDK antrópico

SDK de Google

Verificar la solicitud

Errores comunes en la primera llamada

Próximos pasos

​Flujo

​Elija un estilo de solicitud

​Sin SDK: HTTP directo

​Configuración del SDK

​SDK de OpenAI

​SDK antrópico

​SDK de Google

​Verificar la solicitud

​Errores comunes en la primera llamada

​Próximos pasos

Flujo

Elija un estilo de solicitud

Sin SDK: HTTP directo

Configuración del SDK

SDK de OpenAI

SDK antrópico

SDK de Google

Verificar la solicitud

Errores comunes en la primera llamada

Próximos pasos