Получить доступ

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

REST-интерфейс: OpenAI-совместимый чат и единый createTask для генераций. Авторизация — заголовок X-API-Key.

Аутентификация

Все запросы требуют заголовок X-API-Key с ключом тенанта. Базовый URL:

https://hizone.ru/hubapi/v1

Чат: POST /chat/completions

OpenAI-совместимый эндпоинт: работает с официальными SDK (OpenAI SDK, langchain и т.д.) — достаточно сменить base_url. Поддерживает стриминг ("stream": true, SSE). Списание — по фактическим токенам модели.

curl https://hizone.ru/hubapi/v1/chat/completions \
  -H "X-API-Key: ВАШ_КЛЮЧ" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 1024
  }'

В ответе — стандартный формат chat.completion с полем usage.

Список моделей: GET /models

curl https://hizone.ru/hubapi/v1/models \
  -H "X-API-Key: ВАШ_КЛЮЧ"

Возвращает готовые модели с ценами и единицами тарификации (за 1М токенов, за изображение, за секунду и т.д.).

Генерации: POST /tasks

Изображения, видео и музыка создаются асинхронно: создаёте задачу, затем опрашиваете состояние или получаете вебхук по завершении.

# Создать задачу (изображение)
curl https://hizone.ru/hubapi/v1/tasks \
  -H "X-API-Key: ВАШ_КЛЮЧ" \
  -d '{
    "model": "google/nano-banana",
    "input": {"prompt": "кот в шляпе, акварель", "aspect_ratio": "1:1"},
    "callback_url": "https://ваш-сервер/hook"   # необязательно
  }'

# → {"task_id": "0a39…", "state": "running"}

Получение результата:

# Поллинг
curl https://hizone.ru/hubapi/v1/tasks/0a39… -H "X-API-Key: ВАШ_КЛЮЧ"

# или вебхук: POST на callback_url c подписью X-Hub-Signature

В результате — result с URL файлов (срок хранения ссылок провайдера ограничен — скачивайте результат).

Примеры по модальностям

  • Видео (Veo 3.1): {"model": "veo-3-1", "input": {"prompt": "дроун над горами", "mode": "fast"}}
  • Музыка (Suno): {"model": "ai-music-api/generate", "input": {"prompt": "спокойный лоу-фай", "instrumental": true}}
  • Кавер (Suno): {"model": "ai-music-api/upload-and-cover-audio", "input": {"audio_url": "…", "style": "рок-аранжировка"}}
  • TTS: {"model": "google/gemini-2-5-pro-tts", "input": {"text": "Текст объявления…"}}

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

Ошибки возвращаются в формате {"error": "описание"} с HTTP-кодом. Типовые случаи:

  • 402 — недостаточно средств на балансе;
  • 409 — модель недоступна или у неё нет тарифа;
  • 429 — превышен лимит параллельных задач;
  • при сбое генерации средства возвращаются на баланс автоматически.

Готовы начать?

Выдадим ключ и поможем с интеграцией.

Получить доступ