Hailuo 2.3 API

Hailuo 2.3 API

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

Доступны две модели:

• Стандарт - быстрее и дешевле, подходит для большинства задач.
• Про - внимательнее к деталям, лучше справляется со сложными сценами и крупными планами.

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

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

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

Тело запроса

{
  "tool": "hailuo-2-3",
  "input": {
    "...": "..."
  }
}

• tool - slug нейросети, всегда "hailuo-2-3".
• input - параметры конкретного запуска.

Параметры

Параметр	Тип	Обязательный	Описание
model	enum	Да	Выбор модели. Варианты: hailuo/2-3-image-to-video-standard (Стандарт), hailuo/2-3-image-to-video-pro (Про). Стандарт дешевле и быстрее, Про лучше справляется с детализацией и сложными сценами.
prompt	string	Да	Текстовое описание анимации: что двигается, как двигается камера, какой стиль и настроение. Чем конкретнее описание, тем предсказуемее результат. От 2 до 5000 символов.
image_url	string (url)	Да	URL исходного изображения, которое нейросеть будет оживлять. Допустимые расширения: .jpg, .jpeg, .png, .webp. Только внешние http/https ссылки.
duration	enum	Да	Длительность ролика. Варианты: 6 (6 секунд), 10 (10 секунд). Ограничение: 10 секунд недоступны при разрешении 1080P.
resolution	enum	Да	Разрешение видео. Варианты: 768P, 1080P. Ограничение: 1080P недоступно при длительности 10 секунд.

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

Стандартная модель, 6 секунд, 768P

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "hailuo-2-3",
    "input": {
      "model": "hailuo/2-3-image-to-video-standard",
      "prompt": "Персонаж медленно поворачивает голову вправо, ветер слегка колышет волосы, камера плавно приближается",
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "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-2-3',
    input: {
      model: 'hailuo/2-3-image-to-video-standard',
      prompt:
        'Персонаж медленно поворачивает голову вправо, ветер слегка колышет волосы, камера плавно приближается',
      image_url: 'https://cdn.example.com/source-image-1.jpg',
      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-2-3",
        "input": {
            "model": "hailuo/2-3-image-to-video-standard",
            "prompt": "Персонаж медленно поворачивает голову вправо, ветер слегка колышет волосы, камера плавно приближается",
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "duration": "6",
            "resolution": "768P",
        },
    },
    timeout=30,
)

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

Про модель, 6 секунд, 1080P

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "hailuo-2-3",
    "input": {
      "model": "hailuo/2-3-image-to-video-pro",
      "prompt": "Крупный план лица, модель моргает, лёгкая улыбка, мягкий студийный свет, камера неподвижна",
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "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-2-3',
    input: {
      model: 'hailuo/2-3-image-to-video-pro',
      prompt:
        'Крупный план лица, модель моргает, лёгкая улыбка, мягкий студийный свет, камера неподвижна',
      image_url: 'https://cdn.example.com/source-image-1.jpg',
      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-2-3",
        "input": {
            "model": "hailuo/2-3-image-to-video-pro",
            "prompt": "Крупный план лица, модель моргает, лёгкая улыбка, мягкий студийный свет, камера неподвижна",
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "duration": "6",
            "resolution": "1080P",
        },
    },
    timeout=30,
)

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

Стандартная модель, 10 секунд, 768P

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "hailuo-2-3",
    "input": {
      "model": "hailuo/2-3-image-to-video-standard",
      "prompt": "Панорама города на закате, машины медленно едут по улице, облака плывут, камера плавно движется слева направо",
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "duration": "10",
      "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-2-3',
    input: {
      model: 'hailuo/2-3-image-to-video-standard',
      prompt:
        'Панорама города на закате, машины медленно едут по улице, облака плывут, камера плавно движется слева направо',
      image_url: 'https://cdn.example.com/source-image-1.jpg',
      duration: '10',
      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-2-3",
        "input": {
            "model": "hailuo/2-3-image-to-video-standard",
            "prompt": "Панорама города на закате, машины медленно едут по улице, облака плывут, камера плавно движется слева направо",
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "duration": "10",
            "resolution": "768P",
        },
    },
    timeout=30,
)

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

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

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

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

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

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "hailuo-2-3",
  "cost": 30,
  "created_at": "2026-03-29T12:00:00Z",
  "completed_at": "2026-03-29T12:00:45Z",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/hailuo-2-3/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-2-3/result.mp4"
  ]
}

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

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

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

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

Модель	Длительность	Разрешение	Цена
Стандарт	6 сек	768P	30 ₽
Стандарт	10 сек	768P	50 ₽
Стандарт	6 сек	1080P	50 ₽
Про	6 сек	768P	45 ₽
Про	10 сек	768P	90 ₽
Про	6 сек	1080P	80 ₽

Комбинация 10 сек + 1080P недоступна ни для одной модели.

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

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