Guía de la API de Claude

Claude en TokenHub — Modelos Anthropic OpenAI-Compatible

Llama a los modelos Claude de Anthropic a través del endpoint unificado /chat/completions de TokenHub. Formato de request y response totalmente OpenAI-compatible — no requiere migración de SDK. Streaming, uso de herramientas (function calling) y vision (image input) están todos soportados. Facturación por token según el nivel del model.

OpenAI-CompatibleStreamingTool UseVisionClaude 3 → 4.7Token-based

1Obtén tu API Key

Visita tokenhub.store y registra una cuenta (se admite inicio de sesión con GitHub / Google)
Ve a Dashboard → API Keys y haz clic en "Create New Key"
Ve a Dashboard → Billing para añadir Credits (1 Credit = $1 USD)
Copia el API Key (formato: th-xxxxxxxxxxxx...)

⚠️ El API Key se muestra solo una vez al crearlo. Guárdalo de forma segura; si lo pierdes, crea uno nuevo.

2Resumen de la API

Base URL

https://tokenhub.store/api/v1

Autenticación

Incluye el API Key en el encabezado Authorization:

Header

Authorization: Bearer th-your-api-key

Endpoint (OpenAI-compatible)

POST

/chat/completions

Chat completion. El mismo esquema que OpenAI /v1/chat/completions, incluyendo streaming, uso de herramientas, vision y modo JSON.

Puedes seguir usando el SDK oficial de openai — solo apunta base_url a TokenHub y usa tu API Key de TokenHub. No se necesitan más cambios en el código.

3Models y precios

El precio es por 1 millón de tokens (USD). Solo se cobran las llamadas exitosas. Se aceptan tanto el ID canónico como el alias anthropic/*.

Nivel	ID del model	Entrada	Salida	Notas
Opus 4.7	anthropic/claude-opus-4-7	$5.00	$25.00	Lo más reciente, con la mayor calidad en razonamiento y programación.
Opus 4.6	anthropic/claude-opus-4-6	$5.00	$25.00	Lo más reciente, con la mayor calidad en razonamiento y programación.
Sonnet 4.6	anthropic/claude-sonnet-4-6	$3.00	$15.00	Equilibrio insignia entre calidad y coste (valor predeterminado recomendado).
Haiku 4.5	anthropic/claude-haiku-4-5	$1.00	$5.00	El más rápido y económico de 4-gen; ideal para alto QPS y clasificación.
Sonnet 4.5	anthropic/claude-sonnet-4-5	$3.00	$15.00	Modelo de uso general de la generación anterior.
Opus 4.5	anthropic/claude-opus-4-5	$5.00	$25.00	Lo más reciente, con la mayor calidad en razonamiento y programación.
Sonnet 4	anthropic/claude-4-sonnet	$3.00	$15.00	Modelo de uso general de la generación anterior.
Opus 4	anthropic/claude-4-opus	$15.00	$75.00	Lo más reciente, con la mayor calidad en razonamiento y programación.
3.5 Sonnet	anthropic/claude-3-5-sonnet-latest	$3.00	$15.00	Estable, probado en producción; ampliamente compatible.
3.5 Haiku	anthropic/claude-3-5-haiku-latest	$0.80	$4.00	Estable, probado en producción; ampliamente compatible.

4Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
model	string	Obligatorio	—	ID del model Claude. Ejemplo: "anthropic/claude-sonnet-4-6". Se aceptan tanto el formato con prefijo anthropic/* como el nombre corto sin prefijo.
messages	array	Obligatorio	—	Historial del chat. Cada elemento es { role, content }. role ∈ system \| user \| assistant. content es una cadena o un array de partes (para vision / resultados de herramientas).
max_tokens	integer	Opcional	1024	Máximo de tokens de salida (Claude lo requiere). Típicamente 1024–4096.
temperature	number	Opcional	1.0	Sampling temperature, 0.0–1.0. Lower = more deterministic.
top_p	number	Opcional	1.0	Muestreo nucleus. Usa temperature O top_p, no ambos.
stream	boolean	Opcional	false	Si es true, devuelve deltas de Server-Sent Events (SSE).
stop	string[]	Opcional	—	Hasta 4 secuencias de parada.
tools	array	Opcional	—	Lista de definiciones de herramientas/funciones para el uso de herramientas (function calling).
tool_choice	string\|object	Opcional	auto	Controla la selección de herramientas: auto \| none \| required \| { type:'function', function:{ name } }.
response_format	object	Opcional	—	Modo JSON: { "type": "json_object" } obliga al model a devolver JSON válido.
user	string	Opcional	—	ID opcional del usuario final para tu propio seguimiento.

5Ejemplos con curl

bash

curl https://tokenhub.store/api/v1/chat/completions \
  -H "Authorization: Bearer th-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-6",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain CAP theorem in 3 bullets."}
    ],
    "max_tokens": 512,
    "temperature": 0.3
  }'

6Ejemplo en Python

python

from openai import OpenAI

client = OpenAI(
    api_key="th-your-api-key",
    base_url="https://tokenhub.store/api/v1",
)

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-4-6",
    max_tokens=512,
    temperature=0.3,
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain CAP theorem in 3 bullets."},
    ],
)

print(resp.choices[0].message.content)
print("usage:", resp.usage)

7Ejemplo de JavaScript / Node.js

javascript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "th-your-api-key",
  baseURL: "https://tokenhub.store/api/v1",
});

const resp = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-4-6",
  max_tokens: 512,
  temperature: 0.3,
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "Explain CAP theorem in 3 bullets." },
  ],
});

console.log(resp.choices[0].message.content);
console.log("usage:", resp.usage);

8Consejos de uso

Establece siempre max_tokens — Claude lo trata como requerido semánticamente. Sin él, las generaciones largas pueden truncarse antes de lo esperado.
Pon las instrucciones en un solo mensaje del sistema; mantén los turnos del usuario centrados. Claude sigue las instrucciones del sistema con mucha firmeza.
Para extracción estructurada, combina un prompt del sistema como 'Return only JSON' con response_format: { type: 'json_object' }.
El Streaming mejora mucho la latencia percibida en respuestas largas. El formato delta coincide exactamente con OpenAI.
Haiku-4-5 cuesta ~5× menos que Sonnet-4-6, con una capacidad similar para tareas cortas — dirige las consultas simples a Haiku para ahorrar costos.
Visión: pasa las imágenes como { type: 'image_url', image_url: { url: 'https://...' } } dentro del array content. También se aceptan Data URIs (base64).

9Preguntas frecuentes

¿Listo para empezar?

Regístrate en TokenHub y empieza a llamar a Claude a través de nuestra API compatible con OpenAI

Recargar Credits Obtener API Key