Inicio / Documentación

Documentación de la API de ThunderPeak

Una pasarela, todos los protocolos. De cero a tu primera llamada a un modelo en dos minutos.

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 URLLlamada de ejemplo
OpenAI SDK / Chathttps://thunder-peak.com/v1POST /v1/chat/completions
Anthropic SDK / Messageshttps://thunder-peak.comPOST /v1/messages
Responses (Codex)https://thunder-peak.com/v1POST /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

Claude Code
export ANTHROPIC_BASE_URL=https://thunder-peak.com
export ANTHROPIC_AUTH_TOKEN=$THUNDERPEAK_KEY
claude
Codex CLI
codex --config set model_provider thunderpeak
codex --config set model gpt-6-astra
# base_url https://thunder-peak.com/v1 · responses
Cursor
Ajustes → Modelos → Compatible con OpenAI: base URL https://thunder-peak.com/v1, clave sk-tp-…, prefijo de modelo desactivado.
Cherry Studio
添加 OpenAI 兼容提供商 → API 地址 https://thunder-peak.com/v1 → API Key → 模型列表自动拉取。
CodeWhale
# ~/.codewhale/config.toml
provider = "openai"
base_url = "https://thunder-peak.com/v1"
api_key = "sk-tp-…"
model = "glm-5.3" # any model we serve
Agente de código para terminal, modelos abiertos primero — admite pasarelas personalizadas.
Python OpenAI SDK
client = OpenAI(base_url="https://thunder-peak.com/v1", api_key="sk-tp-…")
Extensiones de VS Code
Usa la opción de proveedor compatible con OpenAI, pega la base URL y la clave; muchas extensiones descubren los modelos automáticamente.

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

EstadoSignificadoAcción
400Petición malformada / modelo desconocido para tu claveComprueba el ID del modelo en GET /v1/models
401Clave ausente o no válidaRevisa la cabecera de la clave
402Saldo insuficienteRecarga (USDT)
404Endpoint incorrecto para la familia de modelosUsa la base URL correcta según la tabla de protocolos
429Límite de velocidad por clave alcanzadoEspera o sube el límite de la clave en la consola
5xxProblema del proveedor de origenEspera 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.