Documentação da API ThunderPeak

Início rápido

1. Cadastre-se em console.thunder-peak.com e crie uma chave de API (sk-tp-…).
2. Aponte sua ferramenta para a base URL abaixo.
3. Envie sua primeira requisição.

Teste com curl (chat compatível com OpenAI):

Dica: consulte sua lista de modelos a qualquer momento com GET /v1/models usando a mesma chave — o catálogo está sempre atualizado e é por chave.

Protocolos e endpoints

Os três formatos compartilham uma chave e um saldo. Os corpos de requisição e as respostas são compatíveis byte a byte com as APIs de origem — aponte qualquer SDK oficial para a base URL correspondente.

• Chat Completions — mensagens no formato OpenAI, chamada de funções e streaming via SSE. Use com SDKs da OpenAI, Cherry Studio e a maioria das ferramentas.
• Anthropic Messages — x-api-key cabeçalho + anthropic-version. Use com Claude Code e o SDK da Anthropic.
• Responses — o protocolo moderno de agentes da OpenAI usado pelo Codex CLI e extensão.

Geração de vídeo

O HappyHorse 1.1 gera vídeo a partir de texto, uma imagem ou um clipe de referência. Usa a mesma chave de API e o mesmo saldo dos seus modelos de chat.

• Interface web: abra /video, cole sua chave, descreva a cena e gere.
• API: POST /api/video/generate com {key, model, prompt, size, duration} → retorna um task_id; consulte POST /api/video/status até state = SUCCEEDED e leia a url.
• Modelos: happyhorse-1.1-t2v (texto), happyhorse-1.1-i2v (imagem), happyhorse-1.1-r2v (referência).
• Preços: 720P $0.38 por clipe de 5 segundos · 1080P $0.68 por clipe de 5 segundos (10s = ×2). Cobrado ao aceitar o trabalho; os que falham são reembolsados automaticamente.
• Observações: a geração costuma levar 1–3 minutos; os links de saída são temporários, baixe logo.

Configuração de ferramentas

Cobrança e tokens

• Os créditos não expiram. Recarregue com USDT em TRC-20 / BSC / Solana (mín. $10): copie o endereço na Planos página, faça a transferência e cole seu TXID de volta naquela página — o saldo é creditado automaticamente, geralmente em um minuto.
• Contas novas recebem $2.50 de crédito de teste grátis após a verificação de e-mail — teste o gateway antes de comprar créditos.
• A medição por requisição cobre tokens de entrada, saída, escrita em cache, leitura de cache e raciocínio. Streaming custa o mesmo que sem streaming.
• Preços listados: Claude e GPT a 66% das tarifas oficiais; DeepSeek e Kimi K3 a 88%; GLM-5.3 a 80%, GLM-5.2 a 70%; Qwen na tarifa oficial. Os descontos são política permanente, não uma promoção.
• Seu saldo e uso por chave aparecem no console; consulte o saldo pelo servidor com GET /v1/balance.

Visão

qwen3-vl-plus entende imagens: descreve capturas, lê documentos, faz OCR ou analisa fotos. Usa a mesma chave de API e saldo dos seus modelos de chat.

• Formato de chamada (compatível com 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"}}
      ]
    }]
  }

• Preços: $0.32 / $1.28 por 1M de tokens (tarifas oficiais). As imagens são cobradas como tokens de imagem (cerca de 100–1200 tokens por imagem conforme o tamanho).
• Fontes de imagem: use uma URL publicamente acessível ou incorpore a imagem como data URL base64 (data:image/png;base64,...).
• Proxy de imagens (recomendado para imagens hospedadas no exterior): nossa região de inferência fica na China continental, então hosts de imagens no exterior podem dar timeout. Envolva qualquer URL externa com nosso proxy e funciona em qualquer lugar:
  https://thunder-peak.com/img-proxy?u=<URL-encoded image url>
  Exemplo: https://thunder-peak.com/img-proxy?u=https%3A%2F%2Fpicsum.photos%2F400%2F300
  O proxy busca a imagem uma vez, faz cache e serve pelo nosso domínio — menos de um segundo em chamadas repetidas.

Erros e limites de taxa

As chaves têm por padrão um limite conservador de requisições por minuto; aumente ou reduza por chave no console. Durante quedas da origem o gateway retorna 5xx enquanto GET /v1/models and /healthz continuam verdes — essa distinção significa que o problema é da origem, não da sua chave.