Guía de migración

Migrar desde OpenRouter

Si usas OpenRouter, migrar a HypersHub solo requiere cambiar la URL de la API y la clave. Ambos ofrecen una puerta de enlace API unificada compatible con OpenAI.

Diferencias clave

Elemento	OpenRouter	HypersHub
URL de API	https://openrouter.ai/api/v1	https://apiclaw.cc/v1
Formato de clave API	sk-or-vv-...	hy-...
Protocolos soportados	Compatible con OpenAI	Compatible con OpenAI (incl. Gemini) + Claude nativo
Moneda de facturación	USD	RMB (¥)
Granularidad de facturación	Facturación por token	Facturación por token, descuentos automáticos de Prompt Cache
Servicios adicionales	Ranking de modelos, reseñas de comunidad	Consola unificada, plataforma Agent, gestión operativa

Pasos de migración

Solo dos cosas cambian: URL base y clave API. Código, formato de solicitud y llamadas SDK permanecen igual.

1. Regístrate y obtén una clave API

Inicia sesión en la consola HypersHub, ve a Claves API y crea una nueva clave. Las claves empiezan con hy- — cópiala al crearla.

2. Reemplaza la URL base

En tu código existente, reemplaza la URL de OpenRouter por la de HypersHub. Usa los IDs de modelo de HypersHub.

# OpenRouter old code
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-vv-...",
)

# --- After migration ---
client = OpenAI(
    base_url="https://apiclaw.cc/v1",
    api_key="hy-xxxxxxxxxxxx",
)

completion = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello"}],
)

Mapeo de nombres de modelo

OpenRouter usa el formato organización/modelo; HypersHub usa IDs cortos. Consulta el mapeo a continuación:

Modelo	OpenRouter ID	HypersHub ID
Claude Opus 4.8	anthropic/claude-opus-4-8	claude-opus-4-8
Claude Opus 4.7	anthropic/claude-opus-4-7	claude-opus-4-7
Claude Sonnet 4.6	anthropic/claude-sonnet-4-6	claude-sonnet-4-6
Claude Haiku 4.5	anthropic/claude-4-5-haiku	claude-haiku-4-5-20251001
GPT-5.5	openai/gpt-5.5	gpt-5.5
GPT-5.4	openai/gpt-5.4	gpt-5.4
GPT-5.4-mini	openai/gpt-5.4-mini	gpt-5.4-mini
Gemini 3.1 Pro	google/gemini-3.1-pro	gemini-3.1-pro-preview
DeepSeek V4 Pro	deepseek/deepseek-v4	deepseek-v4-pro
DeepSeek V4 Flash	deepseek/deepseek-v4-flash	deepseek-v4-flash

Funciones exclusivas de HypersHub

Más allá de los endpoints compatibles con OpenAI, HypersHub ofrece estas funciones no disponibles en OpenRouter:

Nota: Los modelos Gemini se sirven mediante endpoints compatibles con OpenAI. No se proporcionan endpoints nativos Gemini.

API nativa de Claude

Usa /v1/messages para la API Messages nativa de Anthropic con Extended Thinking. Autenticación con encabezado x-api-key.

CLI oficial

@hypershub/cli ofrece hy init para configuración rápida de Claude Code, Codex, OpenCode y más; hy use para cambiar de modelo.

SDK TypeScript

@hypershub/sdk ofrece interfaces tipadas para Chat, Responses, Messages y Models con streaming nativo.

Descuentos automáticos de Prompt Cache

Tokens en caché facturados con gran descuento (Claude ~10%, DeepSeek ~1% del precio original) — sin cambios de código.

Consola de operaciones unificada

Gestiona claves API, consulta detalles de uso, configura alertas de presupuesto y gestiona permisos de modelo en un solo lugar.

Migración de herramientas de terceros

Si OpenRouter se usa con Claude Code, Codex u otras herramientas, la migración solo requiere actualizar la URL y la clave.

Herramienta	Método de migración
Claude Code	Ejecuta hy init claude-code; o configura manualmente ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN.
Claude Desktop	En Developer Mode, cambia la URL base y reemplaza la clave API.
Codex	Ejecuta hy init codex; o edita manualmente ~/.codex/config.toml.
OpenCode	Ejecuta hy init opencode; o edita manualmente apiBaseUrl y apiKey.
Otras herramientas compatibles con OpenAI	Cambia la URL base y la clave API — funciona directamente.

Preguntas frecuentes

¿Necesito cambiar mi código?

No. Si usas el SDK de OpenAI con OpenRouter, solo cambia base_url y api_key — el resto del código no cambia.

¿Los IDs de modelo son diferentes?

Sí, deben cambiarse del formato organización/modelo al formato simplificado de HypersHub. Consulta la tabla de mapeo arriba.

¿Puedo usar ambos en el mismo proyecto?

Sí. Crea dos instancias del cliente SDK con diferentes configuraciones. Una vez verificada la migración, elimina OpenRouter.

¿Se admite streaming, tool calling, etc.?

Todo soportado. Streaming (stream=True), tool calling (tools), visión (image_url) y otras funciones compatibles con OpenAI.

¿Cómo verifico la migración?

Ejecuta hy check all --live para verificar conectividad, o envía una solicitud de prueba.