Документация API ThunderPeak

Быстрый старт

1. Зарегистрируйтесь на console.thunder-peak.com и создайте API key (sk-tp-…).
2. Укажите в вашем инструменте base URL ниже.
3. Отправьте первый запрос.

Попробуйте через curl (чат, совместимый с OpenAI):

Совет: в любой момент запросите актуальный список моделей через GET /v1/models тем же ключом — каталог всегда актуален и индивидуален для ключа.

Протоколы и endpoints

Все три формата используют один ключ и один баланс кредитов. Тела запросов и ответы побайтово совместимы с upstream API — укажите в любом официальном SDK соответствующий base URL.

• Chat Completions — сообщения в формате OpenAI, function calling, streaming через SSE. Работает с OpenAI SDK, Cherry Studio и большинством инструментов.
• Anthropic Messages — заголовок x-api-key + anthropic-version. Используется с Claude Code и Anthropic SDK.
• Responses — современный агентный протокол OpenAI, используемый Codex CLI и расширением.

Генерация видео

HappyHorse 1.1 генерирует видео из текста, изображения или референсного клипа. Он использует тот же API key и тот же баланс, что и ваши чат-модели.

• Web-интерфейс: откройте /video, вставьте ключ, опишите сцену и генерируйте.
• API: POST /api/video/generate с {key, model, prompt, size, duration} → возвращает task_id; опрашивайте POST /api/video/status, пока state = SUCCEEDED, и прочитайте url.
• Модели: happyhorse-1.1-t2v (текст), happyhorse-1.1-i2v (изображение), happyhorse-1.1-r2v (референс).
• Цены: 720P $0.38 за 5-секундный клип · 1080P $0.68 за 5-секундный клип (10 с = ×2). Списывается при приёме задачи; за неудачные задачи средства возвращаются автоматически.
• Примечания: генерация обычно занимает 1–3 минуты; ссылки на результат временные — скачивайте сразу.

Настройка инструментов

Оплата и токены

• Кредиты не сгорают. Пополняйте в USDT в TRC-20 / BSC / Solana (минимум $10): скопируйте адрес на странице Тарифы, отправьте перевод, затем вставьте TXID обратно на этой странице — баланс зачисляется автоматически, обычно в течение минуты.
• Новые аккаунты получают $2.50 бесплатного тестового кредита после подтверждения email — попробуйте шлюз перед покупкой кредитов.
• Тарификация по каждому запросу учитывает входные и выходные токены, запись в cache, чтение из cache и токены размышления. Streaming стоит столько же, сколько обычный режим.
• Указанные цены: Claude и GPT по 66% от официальных; DeepSeek и Kimi K3 — 88%; GLM-5.3 — 80%, GLM-5.2 — 70%; Qwen — по официальным. Скидки — это постоянная политика, а не акция.
• Ваш баланс и использование по каждому ключу видны в консоли; запрашивайте баланс на сервере через GET /v1/balance.

Vision

qwen3-vl-plus понимает изображения: описывает скриншоты, читает документы, OCR и анализирует фото. Использует тот же API key и баланс, что и ваши чат-модели.

• Формат вызова (OpenAI-compatible):

  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"}}
      ]
    }]
  }

• Цены: $0.32 / $1.28 за 1M токенов (официальные ставки). Изображения тарифицируются как image-токены (примерно 100–1200 токенов на изображение в зависимости от размера).
• Источники изображений: используйте публично доступный URL или встраивайте изображение как base64 data URL (data:image/png;base64,...).
• Proxy изображений (рекомендуется для изображений, размещённых за рубежом): наши серверы вывода находятся в материковом Китае, поэтому зарубежные хостинги изображений могут не ответить вовремя. Оберните любой внешний URL в наш proxy, и он заработает везде:
  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
  Proxy загружает изображение один раз, кэширует его и отдаёт с нашего домена — при повторных вызовах ответ за доли секунды.

Ошибки и лимиты

По умолчанию у ключей консервативный лимит запросов в минуту; повышайте или понижайте его для каждого ключа в консоли. Во время сбоев upstream шлюз возвращает 5xx, тогда как GET /v1/models и /healthz остаются зелёными — это различие означает, что проблема у upstream, а не в вашем ключе.