Документация 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 — превышен лимит параллельных задач;
- при сбое генерации средства возвращаются на баланс автоматически.