Превращает картинку в короткое видео, добавляя движение персонажей и камеры по вашему заданию. Стоимость от 30 до 90 рублей за генерацию - зависит от модели, длительности и разрешения.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Hailuo 2.3 оживляет статичную картинку - превращает её в короткий видеоролик с движением персонажей, объектов и камеры. Вы загружаете изображение, описываете, какая анимация нужна, и получаете 6- или 10-секундное видео.
Доступны две модели:
Каждый вызов создаёт асинхронную операцию. API сразу возвращает id и стартовый статус, а готовое видео нужно забрать отдельной проверкой.
POST /api/v1/operationsAuthorization: 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 секунд. |
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"
}
}'
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)
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())
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"
}
}'
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)
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())
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"
}
}'
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)
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 и используйте его для проверки статуса:
GET /api/v1/operations/{id}id возвращается сразу после POST /api/v1/operations.curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
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 не принимаются.