Hailuo 02 API

Hailuo 02 API

Hailuo 02 генерирует короткие видеоролики двумя способами: по текстовому описанию или из загруженного изображения. Вы описываете сцену, при необходимости прикладываете картинку - и получаете готовый ролик на 6 или 10 секунд.

Два режима работы:

• Видео из текста - нейросеть создаёт ролик целиком по описанию.
• Видео из изображения - нейросеть «оживляет» загруженную картинку, добавляя движение объектов и камеры.

В режиме «Видео из изображения» можно дополнительно задать конечный кадр - изображение, на котором ролик должен завершиться. Это удобно для сценариев «до/после» или точного финала сцены.

Две модели:

• Standard - экономичный вариант с разрешением 512P или 768P и длительностью 6 или 10 секунд.
• Pro - максимальное качество в 1080p, только 6 секунд.

Каждый вызов создаёт асинхронную операцию. API сразу возвращает id и стартовый статус, а готовое видео нужно забрать отдельной проверкой.

Создание операции

• Endpoint: POST /api/v1/operations
• Авторизация: Authorization: Bearer brth_...
• Запрос создаёт новую операцию и сразу возвращает id, стартовый статус и стоимость.
• Выполнение асинхронное.

Тело запроса

{
  "tool": "hailuo-02",
  "input": {
    "...": "..."
  }
}

• tool - slug нейросети, всегда "hailuo-02".
• input - параметры конкретного запуска. Набор полей зависит от выбранного режима.

Параметры

Параметр	Тип	Обязательный	Описание
hailuo_generation_type	enum	Да	Тип генерации. Варианты: image (видео из изображения), text (видео из текста).
hailuo_tier	enum	Да	Модель. Варианты: standard (Standard), pro (Pro). Standard поддерживает разрешения 512P/768P и длительность 6/10 секунд. Pro работает только в 1080p и 6 секунд.
prompt	string	Да	Текстовое описание сцены: что происходит в кадре, как движется камера, стиль и настроение. От 3 до 4000 символов.
image_url	string (url)	Да (для image)	URL исходного изображения. Нужен только при hailuo_generation_type: "image". Допустимые расширения: .jpg, .jpeg, .png, .webp. Только внешние http/https ссылки.
use_end_image	boolean	Нет	Включает конечный кадр. Работает только при hailuo_generation_type: "image". Если true, нужно передать end_image_url.
end_image_url	string (url)	Да (если use_end_image = true)	URL изображения конечного кадра. Ролик завершится на этой картинке. Допустимые расширения: .jpg, .jpeg, .png, .webp. Только внешние http/https ссылки.
duration	enum	Да	Длительность видео. Варианты: 6 (6 секунд), 10 (10 секунд). Для Pro доступно только 6.
resolution	enum	Да	Разрешение видео. Варианты: 512P, 768P (только для Standard), 1080p (только для Pro).

Примеры запросов

Видео из текста (Standard, 768P, 6 секунд)

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "hailuo-02",
    "input": {
      "hailuo_generation_type": "text",
      "hailuo_tier": "standard",
      "prompt": "Неоновый город ночью, дождь, машины медленно едут по мокрой дороге, отражения огней в лужах, камера плавно движется вперёд",
      "duration": "6",
      "resolution": "768P"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'hailuo-02',
    input: {
      hailuo_generation_type: 'text',
      hailuo_tier: 'standard',
      prompt:
        'Неоновый город ночью, дождь, машины медленно едут по мокрой дороге, отражения огней в лужах, камера плавно движется вперёд',
      duration: '6',
      resolution: '768P',
    },
  }),
})

const data = await response.json()
console.log(data)

Python

import requests

response = requests.post(
    "https://bratuha.ru/api/v1/operations",
    headers={
        "Authorization": "Bearer brth_ваш_ключ",
        "Content-Type": "application/json",
    },
    json={
        "tool": "hailuo-02",
        "input": {
            "hailuo_generation_type": "text",
            "hailuo_tier": "standard",
            "prompt": "Неоновый город ночью, дождь, машины медленно едут по мокрой дороге, отражения огней в лужах, камера плавно движется вперёд",
            "duration": "6",
            "resolution": "768P",
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Видео из изображения (Standard, 768P, 6 секунд)

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "hailuo-02",
    "input": {
      "hailuo_generation_type": "image",
      "hailuo_tier": "standard",
      "prompt": "Персонаж медленно поворачивает голову вправо, ветер слегка колышет волосы, камера плавно приближается",
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "use_end_image": false,
      "duration": "6",
      "resolution": "768P"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'hailuo-02',
    input: {
      hailuo_generation_type: 'image',
      hailuo_tier: 'standard',
      prompt:
        'Персонаж медленно поворачивает голову вправо, ветер слегка колышет волосы, камера плавно приближается',
      image_url: 'https://cdn.example.com/source-image-1.jpg',
      use_end_image: false,
      duration: '6',
      resolution: '768P',
    },
  }),
})

const data = await response.json()
console.log(data)

Python

import requests

response = requests.post(
    "https://bratuha.ru/api/v1/operations",
    headers={
        "Authorization": "Bearer brth_ваш_ключ",
        "Content-Type": "application/json",
    },
    json={
        "tool": "hailuo-02",
        "input": {
            "hailuo_generation_type": "image",
            "hailuo_tier": "standard",
            "prompt": "Персонаж медленно поворачивает голову вправо, ветер слегка колышет волосы, камера плавно приближается",
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "use_end_image": False,
            "duration": "6",
            "resolution": "768P",
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Видео из изображения с конечным кадром (Standard, 512P, 10 секунд)

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "hailuo-02",
    "input": {
      "hailuo_generation_type": "image",
      "hailuo_tier": "standard",
      "prompt": "Плавная трансформация объекта из начального состояния в конечное, мягкий свет, камера неподвижна",
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "use_end_image": true,
      "end_image_url": "https://cdn.example.com/source-image-2.jpg",
      "duration": "10",
      "resolution": "512P"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'hailuo-02',
    input: {
      hailuo_generation_type: 'image',
      hailuo_tier: 'standard',
      prompt:
        'Плавная трансформация объекта из начального состояния в конечное, мягкий свет, камера неподвижна',
      image_url: 'https://cdn.example.com/source-image-1.jpg',
      use_end_image: true,
      end_image_url: 'https://cdn.example.com/source-image-2.jpg',
      duration: '10',
      resolution: '512P',
    },
  }),
})

const data = await response.json()
console.log(data)

Python

import requests

response = requests.post(
    "https://bratuha.ru/api/v1/operations",
    headers={
        "Authorization": "Bearer brth_ваш_ключ",
        "Content-Type": "application/json",
    },
    json={
        "tool": "hailuo-02",
        "input": {
            "hailuo_generation_type": "image",
            "hailuo_tier": "standard",
            "prompt": "Плавная трансформация объекта из начального состояния в конечное, мягкий свет, камера неподвижна",
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "use_end_image": True,
            "end_image_url": "https://cdn.example.com/source-image-2.jpg",
            "duration": "10",
            "resolution": "512P",
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Pro модель (видео из изображения, 1080p, 6 секунд)

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "hailuo-02",
    "input": {
      "hailuo_generation_type": "image",
      "hailuo_tier": "pro",
      "prompt": "Крупный план лица, модель моргает, лёгкая улыбка, мягкий студийный свет, камера неподвижна",
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "use_end_image": false,
      "duration": "6",
      "resolution": "1080p"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'hailuo-02',
    input: {
      hailuo_generation_type: 'image',
      hailuo_tier: 'pro',
      prompt:
        'Крупный план лица, модель моргает, лёгкая улыбка, мягкий студийный свет, камера неподвижна',
      image_url: 'https://cdn.example.com/source-image-1.jpg',
      use_end_image: false,
      duration: '6',
      resolution: '1080p',
    },
  }),
})

const data = await response.json()
console.log(data)

Python

import requests

response = requests.post(
    "https://bratuha.ru/api/v1/operations",
    headers={
        "Authorization": "Bearer brth_ваш_ключ",
        "Content-Type": "application/json",
    },
    json={
        "tool": "hailuo-02",
        "input": {
            "hailuo_generation_type": "image",
            "hailuo_tier": "pro",
            "prompt": "Крупный план лица, модель моргает, лёгкая улыбка, мягкий студийный свет, камера неподвижна",
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "use_end_image": False,
            "duration": "6",
            "resolution": "1080p",
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Примеры ответов

Ответ после создания

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "hailuo-02",
  "cost": 30,
  "balance_after": 495,
  "created_at": "2026-03-30T12:00:00Z"
}

Ответ после завершения

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "hailuo-02",
  "cost": 30,
  "created_at": "2026-03-30T12:00:00Z",
  "completed_at": "2026-03-30T12:01:15Z",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/hailuo-02/result.mp4"
    ]
  },
  "error_message": null
}

Проверка статуса

После создания операции сохраните id и используйте его для проверки статуса:

• Endpoint: GET /api/v1/operations/{id}
• Этот id возвращается сразу после POST /api/v1/operations.

cURL

curl -H "Authorization: Bearer brth_ваш_ключ" \
  https://bratuha.ru/api/v1/operations/op_uuid-123

JavaScript / TypeScript

const response = await fetch(
  'https://bratuha.ru/api/v1/operations/op_uuid-123',
  {
    headers: {
      Authorization: 'Bearer brth_ваш_ключ',
    },
  },
)

const data = await response.json()
console.log(data)

Формат результата

После успешного завершения операция возвращает result в таком формате:

{
  "type": "video",
  "urls": [
    "https://storage.bratuha.ru/results/hailuo-02/result.mp4"
  ]
}

• type - всегда "video".
• urls - массив ссылок на готовые видеофайлы. Возвращается один ролик в формате .mp4.

Если операция завершилась с ошибкой, result будет null, а текст ошибки вернётся в error_message.

Ценообразование

Цена зависит от четырёх параметров: типа генерации, модели, разрешения и длительности.

Тип генерации	Модель	Разрешение	Длительность	Цена
Видео из изображения	Standard	512P	6 сек	12 ₽
Видео из изображения	Standard	512P	10 сек	20 ₽
Видео из изображения	Standard	768P	6 сек	30 ₽
Видео из изображения	Standard	768P	10 сек	48 ₽
Видео из текста	Standard	768P	6 сек	30 ₽
Видео из текста	Standard	768P	10 сек	48 ₽
Видео из изображения	Pro	1080p	6 сек	48 ₽
Видео из текста	Pro	1080p	6 сек	48 ₽

Самый экономичный вариант - видео из изображения в Standard, 512P, 6 секунд (12 ₽). Pro всегда стоит 48 ₽ вне зависимости от типа генерации.

Ограничения и практические заметки

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию.
• Все операции выполняются асинхронно: сначала вы получаете queued, затем отдельно проверяете статус по id.
• Для image_url и end_image_url подходят только внешние http/https URL. localhost, private IP и внутренние адреса не принимаются.
• Допустимые форматы изображений: .jpg, .jpeg, .png, .webp. Форматы HEIC/HEIF, которые поддерживаются при загрузке файлов в UI, в Public API по URL не принимаются.
• Standard поддерживает разрешения 512P и 768P. Pro поддерживает только 1080p. Передача несовместимого разрешения приведёт к ошибке.
• Standard поддерживает длительность 6 и 10 секунд. Pro поддерживает только 6 секунд.
• Конечный кадр (end_image_url) работает только в режиме видео из изображения (hailuo_generation_type: "image"). Для его использования нужно передать use_end_image: true.
• Конкретные описания движения работают лучше общих. «Камера медленно приближается, персонаж поворачивает голову влево» даст более предсказуемый результат, чем «сделай красиво».
• Видео генерируется без звука. Музыку или озвучку нужно добавлять отдельно.