Claude API: clave, el punto final /v1/messages y elección de una versión del modelo

La API de Claude es la forma de llamar a los modelos de Claude desde su propio código en lugar de una ventana de chat: un bot de soporte en su sitio, un script que clasifica los tickets, finalización de código en un editor, una integración de CRM. En NeuralSpace, se crea una clave en su panel de control en aproximadamente un minuto, las solicitudes van al sitio compatible con Anthropic. POST /v1/messages punto final y usted paga desde un saldo simbólico sin suscripción. A continuación se muestra una guía paso a paso: cómo obtener una clave, cómo es su primera llamada y cómo elegir una versión del modelo: Haiku, Sonnet, Opus o Fable.

Qué es la API de Claude y en qué se diferencia del chat

Claude es la familia de modelos lingüísticos de Anthropic. En una ventana de chat hablas con la modelo manualmente; A través de la API, su código hace lo mismo: envía una serie de mensajes, obtiene una respuesta generada y la utiliza en su producto: se la muestra al usuario, la almacena y la procesa aún más. Casos de uso típicos: admitir bots, resumir correos electrónicos y documentos, extraer datos estructurados, redactar contenido, automatizar el trabajo de rutina en scripts. La diferencia clave con el chat es la previsibilidad: usted mismo establece las instrucciones del sistema, el límite de respuesta y la versión del modelo, y ve el gasto en tokens.

Paso 1. Consigue una clave

1. Regístrese en NeuralSpace con su correo electrónico; le llevará menos de un minuto. Los nuevos usuarios reciben créditos de tokens iniciales, suficientes para las primeras solicitudes sin recargar.
2. Abre el Página de claves API en su panel, ingrese un nombre de clave (por ejemplo, "Mi bot") y haga clic en Crear.
3. La clave parece nsk-… y se muestra solo una vez: cópielo directamente en un administrador de contraseñas o en una variable de entorno, no en el código de su repositorio.
4. Verifique su saldo: los modelos de texto requieren al menos 50 tokens en la cuenta. Las recargas se realizan en el panel de control, sin tarifa de suscripción.

Paso 2. Tu primera llamada a /v1/messages

Los modelos de texto de Claude viven en el compatible con Anthropic POST https://neuralspace.pro/v1/messages punto final. El cuerpo lleva el modelo, un messages matriz con user/assistant roles, el límite de respuesta max_tokens (1 a 32000) y un opcional system instrucción. Una solicitud mínima de rizo:

curl https://neuralspace.pro/v1/messages \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "system": "You answer technical questions briefly.",
    "messages": [{"role": "user", "content": "How is streaming different from a regular response?"}]
  }'

La respuesta vuelve en formato antrópico: el texto está en content[0].text y el gasto real está en el usage campo. Autenticar con el x-api-key: nsk-… encabezamiento; Los clientes que solo hablan Portador pueden usar Authorization: Bearer nsk-… en cambio.

Paso 3. Conecte el SDK de Anthropic

Si ya tiene código en el SDK oficial de Anthropic, cambie exactamente dos valores: base_url y la clave:

from anthropic import Anthropic

client = Anthropic(
    base_url="https://neuralspace.pro",
    api_key="nsk-your_key",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="You answer technical questions briefly.",
    messages=[{"role": "user", "content": "Suggest three names for a channel about AI"}],
)
print(resp.content[0].text)

Para interfaces de chat, la transmisión ayuda: agregue "stream": true y la respuesta llega en fragmentos a través de eventos enviados por el servidor, de modo que el usuario ve las primeras palabras antes de que finalice la generación.

¿Qué versión de modelo elegir?

El catálogo público de NeuralSpace tiene cuatro versiones de Claude, y la diferencia entre ellas es el equilibrio entre velocidad y precio frente a la profundidad del razonamiento. Los precios a continuación están en tokens del sitio por millón de tokens API, y la entrada y la salida se facturan por separado (al momento de escribir este artículo; las tarifas son variables):

• Claude Haiku 4.5 (claude-haiku-4-5) — 41 / 213. Los más rápidos y baratos: clasificación, respuestas cortas, procesamiento de textos en masa, etiquetado aproximado.
• Claudio Soneto 5 (claude-sonnet-5) — 152,5 / 767. El caballo de batalla: código, instrucciones largas, diálogos con mucho contexto. Un valor predeterminado sensato.
• Claude Opus 5 (claude-opus-5) — 359/1794,5. Para tareas difíciles: razonamiento de varios pasos, análisis de documentos grandes, lógica sutil.
• Claude Fábula 5 (claude-fable-5) — 718 / 3589,5. El buque insignia para los escenarios más exigentes, donde importa más la calidad que el precio.

Una regla práctica: empezar con Haiku o Soneto y cambiar selectivamente a Opus y Fábula, sólo cuando los dos primeros realmente se queden cortos. La versión la establece un único model campo en la solicitud, para que pueda compararlos en el mismo mensaje.

Streaming, límites y puntos finales de servicio

Dos límites hacen que las personas se despierten temprano: 60 solicitudes por minuto por clave y un saldo mínimo de 50 tokens para modelos de texto. Su saldo actual proviene de GET /v1/balancey una lista legible por máquina de modelos con precios en vivo desde GET /v1/models. Ambos requieren una llave. Las tarifas actuales siempre se muestran en la tabla de la Página de documentación API.

Claude API y MCP: conectándolos a Claude Code

La misma clave conecta NeuralSpace con los agentes de IA como un servidor MCP: el propio agente llama al chat, la generación de imágenes, videos y música en nombre de su cuenta. Para Claude Code es un comando:

claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
  --header "Authorization: Bearer nsk-your_key"

Si aún no necesita la API, los mismos modelos están disponibles en la interfaz, en charlar puedes elegir a Claude y hablar sin código, y el saldo se comparte entre el chat y la API.

Preguntas frecuentes

¿Necesito una cuenta Anthropic o una tarjeta extranjera?

No. La clave se emite en su panel de NeuralSpace y usted paga con tokens de cuenta, sin suscripción ni configuración de facturación en la nube.

¿En qué se diferencia /v1/messages de /v1/chat/completions?

Son dos formatos de la misma API. /v1/messages refleja la API de Anthropic Messages (campos model, messages, system, max_tokens) y se adapta a los modelos Claude y al Anthropic SDK. /v1/chat/completions es el formato OpenAI para los modelos de chat GPT y Grok. Sólo cambian la dirección y la estructura de la carrocería.

¿Cuánto cuesta una llamada a la API de Claude?

Solo para los tokens que realmente usas: Claude Sonnet 5 en el momento de escribir este artículo es 152,5 tokens por millón de entrada y 767 por millón de salida. Una solicitud de un par de miles de tokens cuesta aproximadamente 0,01 dólares. Los precios actuales están en GET /v1/models y en la mesa de documentación.

¿Existe un nivel gratuito?

No hay generaciones libres en la plataforma. Los nuevos usuarios obtienen tokens iniciales, suficientes para las primeras ejecuciones; después de eso, paga por token sin tarifa de suscripción.