ThunderPeak API 문서

빠른 시작

1. console.thunder-peak.com에서 가입하고 API key(sk-tp-…)를 생성하세요.
2. 도구를 아래의 base URL로 지정하세요.
3. 첫 요청을 보내세요.

curl로 시도해 보세요(OpenAI 호환 chat):

팁: 동일한 키로 언제든지 GET /v1/models로 라이브 model 목록을 조회하세요 — 카탈로그는 항상 최신이며 키별로 제공됩니다.

프로토콜 및 endpoint

세 가지 wire format 모두 하나의 키와 하나의 크레딧 잔액을 공유합니다. 요청 본문과 응답은 상위 API와 byte 단위로 호환됩니다 — 모든 공식 SDK를 일치하는 base URL로 지정하세요.

• Chat Completions — OpenAI 형식 messages, function calling, SSE를 통한 streaming. OpenAI SDK, Cherry Studio, 대부분의 도구와 함께 사용하세요.
• Anthropic Messages — x-api-key 헤더 + anthropic-version. Claude Code 및 Anthropic SDK와 함께 사용하세요.
• Responses — Codex CLI/확장 프로그램이 사용하는 최신 OpenAI agent 프로토콜.

비디오 생성

HappyHorse 1.1은 텍스트, 이미지 또는 레퍼런스 클립으로 비디오를 생성합니다. chat model과 동일한 API key와 잔액을 사용합니다.

• 웹 UI: /video를 열고, 키를 붙여넣고, 장면을 설명한 뒤 생성하세요.
• API: {key, model, prompt, size, duration}과 함께 POST /api/video/generate → task_id를 반환합니다. state = SUCCEEDED가 될 때까지 POST /api/video/status를 폴링하고 url을 읽으세요.
• Models: happyhorse-1.1-t2v(텍스트), happyhorse-1.1-i2v(이미지), happyhorse-1.1-r2v(레퍼런스).
• 가격: 720P 5초 클립당 $0.38 · 1080P 5초 클립당 $0.68(10초 = ×2). 작업이 접수될 때 청구되며, 실패한 작업은 자동으로 환불됩니다.
• 참고: 생성은 보통 1–3분 걸립니다. 출력 링크는 임시이므로 즉시 다운로드하세요.

도구 설정

청구 및 token

• 크레딧은 만료되지 않습니다. TRC-20 / BSC / Solana에서 USDT로 충전하세요(최소 $10): Plans 페이지에서 주소를 복사하고, 전송한 뒤, 그 페이지에 TXID를 다시 붙여넣으세요 — 잔액이 자동으로 충전되며 보통 1분 이내입니다.
• 신규 계정은 이메일 인증 후 $2.50의 무료 테스트 크레딧을 받습니다 — 크레딧 구매 전에 gateway를 시험해 보세요.
• 요청당 계량은 input, output, cache-write, cache-read 및 thinking token을 포함합니다. streaming은 non-streaming과 비용이 동일합니다.
• 표시 가격: Claude & GPT는 공식 요율의 66%; DeepSeek & Kimi K3는 88%; GLM-5.3은 80%, GLM-5.2는 70%; Qwen은 공식 요율. 할인은 상시 정책이며 프로모션이 아닙니다.
• 잔액과 키별 사용량은 console에서 확인할 수 있으며, 서버 측에서 GET /v1/balance로 잔액을 조회할 수 있습니다.

비전

qwen3-vl-plus는 이미지를 이해합니다: 스크린샷 설명, 문서 읽기, OCR 또는 사진 분석. chat model과 동일한 API key와 잔액을 사용합니다.

• 호출 형식(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"}}
      ]
    }]
  }

• 가격: 1M token당 $0.32 / $1.28(공식 요율). 이미지는 image token으로 청구됩니다(크기에 따라 이미지당 대략 100–1200 token).
• 이미지 소스: 공개적으로 접근 가능한 URL을 사용하거나, 이미지를 base64 data URL(data:image/png;base64,...)로 인라인하세요.
• 이미지 프록시(해외에 호스팅된 이미지에 권장): 당사의 추론 리전은 중국 본토에 있어 해외 이미지 호스트가 시간 초과될 수 있습니다. 외부 URL을 당사 프록시로 감싸면 어디서든 작동합니다:
  https://thunder-peak.com/img-proxy?u=<URL-encoded image url>
  예: https://thunder-peak.com/img-proxy?u=https%3A%2F%2Fpicsum.photos%2F400%2F300
  프록시는 이미지를 한 번 가져와 캐시하고 당사 도메인에서 제공합니다 — 반복 호출 시 1초 미만입니다.

오류 및 속도 제한

키는 기본적으로 보수적인 분당 요청 수 한도를 가집니다. console에서 키별로 높이거나 낮출 수 있습니다. 상위 서버 장애 중에는 gateway가 5xx를 반환하는 반면 GET /v1/models와 /healthz는 정상(녹색)을 유지합니다 — 이 차이는 문제가 귀하의 키가 아니라 상위 서버에 있음을 의미합니다.