Inicio rápido
1. Regístrate en console.thunder-peak.com y crea una clave de API (sk-tp-…).
2. Apunta tu herramienta a la base URL de abajo.
3. Envía tu primera petición.
| Tu herramienta habla… | Base URL | Llamada de ejemplo |
|---|---|---|
| OpenAI SDK / Chat | https://thunder-peak.com/v1 | POST /v1/chat/completions |
| Anthropic SDK / Messages | https://thunder-peak.com | POST /v1/messages |
| Responses (Codex) | https://thunder-peak.com/v1 | POST /v1/responses |
Pruébalo con curl (chat compatible con OpenAI):
curl https://thunder-peak.com/v1/chat/completions \
-H "Authorization: Bearer $THUNDERPEAK_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Say hello in one line"}]}'
Consejo: consulta tu lista de modelos en vivo en cualquier momento con GET /v1/models con la misma clave — el catálogo siempre está actualizado y es por clave.
Protocolos y endpoints
Los tres formatos comparten una clave y un saldo. Los cuerpos de petición y las respuestas son compatibles byte a byte con las API de origen — apunta cualquier SDK oficial a la base URL correspondiente.
- Chat Completions — mensajes en formato OpenAI, llamada a funciones y streaming por SSE. Úsalo con los SDK de OpenAI, Cherry Studio y la mayoría de herramientas.
- Anthropic Messages — x-api-key cabecera + anthropic-version. Úsalo con Claude Code y el SDK de Anthropic.
- Responses — el protocolo moderno de agentes de OpenAI que usa Codex CLI y su extensión.
Si un cliente de terceros añade rutas de forma extraña, añade o quita /v1 en la base URL — la pasarela acepta ambas formas y normaliza internamente.
Generación de vídeo
HappyHorse 1.1 genera vídeo a partir de texto, una imagen o un clip de referencia. Usa la misma clave de API y el mismo saldo que tus modelos de chat.
- Interfaz web: abre /video, pega tu clave, describe el plano y genera.
- API: POST /api/video/generate con {key, model, prompt, size, duration} → devuelve un task_id; consulta POST /api/video/status hasta que state = SUCCEEDED y lee la url.
- Modelos: happyhorse-1.1-t2v (texto), happyhorse-1.1-i2v (imagen), happyhorse-1.1-r2v (referencia).
- Precios: 720P $0.38 por clip de 5 segundos · 1080P $0.68 por clip de 5 segundos (10s = ×2). Se cobra al aceptar el trabajo; los fallidos se reembolsan automáticamente.
- Notas: la generación suele tardar 1–3 minutos; los enlaces de salida son temporales, descarga cuanto antes.
Configuración de herramientas
export ANTHROPIC_AUTH_TOKEN=$THUNDERPEAK_KEY
claude
codex --config set model gpt-6-astra
# base_url https://thunder-peak.com/v1 · responses
provider = "openai"
base_url = "https://thunder-peak.com/v1"
api_key = "sk-tp-…"
model = "glm-5.3" # any model we serve
Facturación y tokens
- Los créditos no caducan. Recarga con USDT en TRC-20 / BSC / Solana (mín. $10): copia la dirección en la Planes página, haz la transferencia y pega tu TXID de vuelta en esa página — el saldo se acredita automáticamente, normalmente en un minuto.
- Las cuentas nuevas reciben $2.50 de crédito de prueba gratis tras verificar el correo — prueba la pasarela antes de comprar créditos.
- La medición por petición cubre tokens de entrada, salida, escritura de caché, lectura de caché y razonamiento. El streaming cuesta igual que sin streaming.
- Precios publicados: Claude y GPT al 66% de las tarifas oficiales; DeepSeek y Kimi K3 al 88%; GLM-5.3 al 80%, GLM-5.2 al 70%; Qwen a tarifa oficial. Los descuentos son una política permanente, no una promoción.
- Tu saldo y el uso por clave se ven en la consola; consulta el saldo desde el servidor con GET /v1/balance.
Visión
qwen3-vl-plus entiende imágenes: describe capturas, lee documentos, hace OCR o analiza fotos. Usa la misma clave de API y saldo que tus modelos de chat.
- Formato de llamada (compatible con OpenAI):
POST /v1/chat/completions { "model": "qwen3-vl-plus", "messages": [{ "role": "user", "content": [ {"type": "text", "text": "Describe this image"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}} ] }] } - Precios: $0.32 / $1.28 por 1M de tokens (tarifas oficiales). Las imágenes se facturan como tokens de imagen (aproximadamente 100–1200 tokens por imagen según el tamaño).
- Fuentes de imagen: usa una URL accesible públicamente o incrusta la imagen como data URL base64 (data:image/png;base64,...).
- Proxy de imágenes (recomendado para imágenes alojadas en el extranjero): nuestra región de inferencia está en China continental, por lo que los hosts de imágenes en el extranjero pueden agotar el tiempo. Envuelve cualquier URL externa con nuestro proxy y funciona en todas partes:
https://thunder-peak.com/img-proxy?u=<URL-encoded image url>
Ejemplo: https://thunder-peak.com/img-proxy?u=https%3A%2F%2Fpicsum.photos%2F400%2F300
El proxy obtiene la imagen una vez, la cachea y la sirve desde nuestro dominio — menos de un segundo en llamadas repetidas.
Errores y límites de velocidad
| Estado | Significado | Acción |
|---|---|---|
| 400 | Petición malformada / modelo desconocido para tu clave | Comprueba el ID del modelo en GET /v1/models |
| 401 | Clave ausente o no válida | Revisa la cabecera de la clave |
| 402 | Saldo insuficiente | Recarga (USDT) |
| 404 | Endpoint incorrecto para la familia de modelos | Usa la base URL correcta según la tabla de protocolos |
| 429 | Límite de velocidad por clave alcanzado | Espera o sube el límite de la clave en la consola |
| 5xx | Problema del proveedor de origen | Espera y reintenta; comprueba /healthz |
Las claves tienen por defecto un límite conservador de peticiones por minuto; súbelo o bájalo por clave en la consola. Durante caídas del origen la pasarela devuelve 5xx mientras GET /v1/models and /healthz siguen en verde — esa distinción significa que el problema es del origen, no de tu clave.
¿Preguntas? Telegram @thunderpeak_support — respondemos en tu idioma.