Referencia API

Documentación API

Todo lo que necesitas para integrar Claude Max en tus aplicaciones. Endpoints completos, ejemplos de código en 6 lenguajes y los 5 modelos.

Autenticación

URL base

Producción
https://claudemaxhub.com/api/v1

Todas las solicitudes API deben usar HTTPS.

Encabezado de clave API

Encabezado
Authorization: Bearer YOUR_API_KEY

Tu clave API se proporciona después de activar la prueba. Inclúyela en cada solicitud.

Límite de velocidad

60 solicitudes por minuto

Tipo de contenido

application/json

Formato de respuesta

JSON (UTF-8)

Obtener tu clave API

Regístrate para la prueba gratuita → Activa tu cuenta → Encuentra tu clave API en el panel de control.

Modelos disponibles

Todos los modelos incluidos — elige el adecuado para tu caso de uso.

Modelo ID API Ventana de contexto Ideal para
Claude Opus 5 claude-opus-5 200K Razonamiento complejo, investigación, programación
Claude Fable 5 claude-fable-5 1M Documentos largos, grandes bases de código
Claude Opus 4 claude-opus-4-8 200K Análisis, informes detallados
Claude Sonnet 4 claude-sonnet-4 200K Uso general, chat, redacción
Claude Haiku claude-haiku 200K Tareas rápidas, respuestas en tiempo real
GET /api/v1/models Devuelve una lista de todos los modelos Claude disponibles para tu cuenta.
cURL
curl https://claudemaxhub.com/api/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
Python
import requests

response = requests.get(
    "https://claudemaxhub.com/api/v1/models",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

models = response.json()
for model in models["data"]:
    print(f"{model['id']}: {model['description']}")
JavaScript
const response = await fetch(
  'https://claudemaxhub.com/api/v1/models',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
    },
  }
);

const { data } = await response.json();
data.forEach(model => console.log(model.id));
200 — Success
{
  "data": [
    {"id": "claude-opus-5",   "description": "El más potente — razonamiento avanzado y análisis complejo",   "context_window": 200000},
    {"id": "claude-fable-5",  "description": "Modelo insignia — ventana de contexto de 1M tokens",  "context_window": 1000000},
    {"id": "claude-opus-4-8",   "description": "Análisis profundo y tareas complejas de múltiples pasos",   "context_window": 200000},
    {"id": "claude-sonnet-4", "description": "Mejor equilibrio entre velocidad y calidad", "context_window": 200000},
    {"id": "claude-haiku",    "description": "Respuestas más rápidas — ideal para aplicaciones en tiempo real",    "context_window": 200000}
  ]
}
Crear chat
POST /api/v1/chat Envía un mensaje a un modelo Claude y recibe una respuesta. Este es el endpoint principal para todas las interacciones.
model requerido
string
El modelo a usar para la respuesta.
messages requerido
array
Array de objetos de mensaje con rol y contenido.
max_tokens
integer
Número máximo de tokens en la respuesta.
temperature
float
Controla la aleatoriedad. 0 = determinista, 1 = creativo.
stream
boolean
Habilitar respuestas en streaming.
cURL
curl -X POST https://claudemaxhub.com/api/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [
      {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    "max_tokens": 1024,
    "temperature": 0.7
  }'
Python
import requests

response = requests.post(
    "https://claudemaxhub.com/api/v1/chat",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5",
        "messages": [
            {"role": "user", "content": "Explain quantum computing in simple terms."}
        ],
        "max_tokens": 1024,
        "temperature": 0.7,
    },
)

data = response.json()
print(data["content"][0]["text"])
JavaScript (Node.js / Fetch)
const response = await fetch('https://claudemaxhub.com/api/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'claude-opus-5',
    messages: [
      { role: 'user', content: 'Explain quantum computing in simple terms.' },
    ],
    max_tokens: 1024,
    temperature: 0.7,
  }),
});

const data = await response.json();
console.log(data.content[0].text);
PHP (cURL)
$ch = curl_init('https://claudemaxhub.com/api/v1/chat');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model'       => 'claude-opus-5',
        'messages'    => [
            ['role' => 'user', 'content' => 'Explain quantum computing in simple terms.'],
        ],
        'max_tokens'  => 1024,
        'temperature' => 0.7,
    ]),
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['content'][0]['text'];
Go
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "io"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "model": "claude-opus-5",
        "messages": []map[string]string{
            {"role": "user", "content": "Explain quantum computing in simple terms."},
        },
        "max_tokens":  1024,
        "temperature": 0.7,
    })

    req, _ := http.NewRequest("POST",
        "https://claudemaxhub.com/api/v1/chat",
        bytes.NewBuffer(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}
Ruby
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://claudemaxhub.com/api/v1/chat')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
  model: 'claude-opus-5',
  messages: [
    { role: 'user', content: 'Explain quantum computing in simple terms.' }
  ],
  max_tokens: 1024,
  temperature: 0.7
}.to_json

response = http.request(request)
data = JSON.parse(response.body)
puts data['content'][0]['text']
200 — Respuesta exitosa
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5",
  "content": [
    {
      "type": "text",
      "text": "Quantum computing uses quantum bits (qubits) that can exist in multiple states simultaneously..."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 128
  }
}
id
string
Identificador único del mensaje
model
string
Modelo usado para la respuesta
content
array
Array de bloques de contenido (texto)
stop_reason
string
Razón de parada del modelo: end_turn, max_tokens
usage
object
Estadísticas de uso de tokens
Manejo de errores

Todas las respuestas de error posibles y cómo manejarlas.

Estado HTTP Descripción Solución
401 Clave API inválida o faltante Verifica tu clave API en el panel de control
403 Cuenta no activada o prueba expirada Activa tu cuenta o renueva tu suscripción
404 Endpoint inválido o modelo no encontrado Verifica la URL y el nombre del modelo
422 Parámetros de solicitud inválidos Revisa el formato del cuerpo de la solicitud
429 Límite de velocidad excedido Espera y reintenta, o reduce la frecuencia de solicitudes
500 Error interno del servidor Reintenta después de unos segundos

¿Listo para construir con Claude Max?

Obtén tu clave API gratuita con una prueba de 30 días. Los 5 modelos incluidos, sin cargo a tarjeta de crédito.