LongCat Avatar 1.5 Multi API

LongCat Avatar 1.5 Multi API

LongCat Avatar 1.5 Multi оживляет сразу двух людей на одной фотографии. Вы присылаете снимок, где один человек стоит или сидит слева, а другой справа, и две аудиодорожки - по одной на каждого. Нейросеть двигает губы каждого в такт его записи, добавляет мимику и движения головы. Так делают диалоги для роликов, интервью, сценки с парой ведущих и поздравления от двоих.

Что можно настроить:

• порядок речи order - говорят одновременно или по очереди (слева, потом справа или наоборот);
• качество видео - 480p или 720p, от него зависит цена за секунду;
• текстовое задание prompt - кто как себя ведёт, пока говорит или слушает. Его можно не передавать.

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

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

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

Сценарии вызова:

• фото и две дорожки - минимальный запрос: обе дорожки звучат одновременно, видео в 480p;
• диалог по очереди - order: "left_right" или "right_left", можно добавить задание;
• то же в 720p - вдвое дороже за секунду.

Тело запроса

{
  "tool": "longcat-avatar-1-5-multi",
  "input": {
    "image": "https://cdn.example.com/two-people.jpg",
    "left_audio": "https://cdn.example.com/left-voice.mp3",
    "right_audio": "https://cdn.example.com/right-voice.mp3",
    "order": "left_right",
    "resolution": "480p"
  }
}

• tool - slug нейросети, всегда "longcat-avatar-1-5-multi".
• input - параметры запуска. Поля передаются прямо внутри этого объекта, без дополнительной вложенности.

Параметры

Длительность дорожек сервер определяет сам. Цена считается по их общей длине, но не больше чем за 64 секунды (подробнее - в разделе «Ценообразование»).

Ссылки на файлы должны открываться без авторизации по http/https, размер файла - до 128 МБ. Расширение в ссылке должно совпадать с одним из допустимых форматов, иначе API вернёт validation_error.

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

Фото и две дорожки

Минимальный запрос: порядок и качество не указаны, поэтому обе дорожки звучат одновременно, видео в 480p.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "longcat-avatar-1-5-multi",
  "input": {
    "image": "https://cdn.example.com/two-people.jpg",
    "left_audio": "https://cdn.example.com/left-voice.mp3",
    "right_audio": "https://cdn.example.com/right-voice.mp3"
  }
}'

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: 'longcat-avatar-1-5-multi',
    input: {
      image: 'https://cdn.example.com/two-people.jpg',
      left_audio: 'https://cdn.example.com/left-voice.mp3',
      right_audio: 'https://cdn.example.com/right-voice.mp3',
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'longcat-avatar-1-5-multi',
        'input': {
            'image': 'https://cdn.example.com/two-people.jpg',
            'left_audio': 'https://cdn.example.com/left-voice.mp3',
            'right_audio': 'https://cdn.example.com/right-voice.mp3',
        },
    },
    timeout=30,
)

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

Диалог по очереди с заданием

Человек слева говорит первым, человек справа отвечает. Задание описывает, как каждый ведёт себя, пока говорит и слушает.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "longcat-avatar-1-5-multi",
  "input": {
    "image": "https://cdn.example.com/couple-on-sofa.jpg",
    "left_audio": "https://cdn.example.com/left-question.mp3",
    "right_audio": "https://cdn.example.com/right-answer.mp3",
    "order": "left_right",
    "resolution": "480p",
    "prompt": "Женщина слева говорит первой, радостно; мужчина справа молчит и слушает, потом отвечает с лёгкой усмешкой. Камера неподвижна"
  }
}'

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: 'longcat-avatar-1-5-multi',
    input: {
      image: 'https://cdn.example.com/couple-on-sofa.jpg',
      left_audio: 'https://cdn.example.com/left-question.mp3',
      right_audio: 'https://cdn.example.com/right-answer.mp3',
      order: 'left_right',
      resolution: '480p',
      prompt: 'Женщина слева говорит первой, радостно; мужчина справа молчит и слушает, потом отвечает с лёгкой усмешкой. Камера неподвижна',
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'longcat-avatar-1-5-multi',
        'input': {
            'image': 'https://cdn.example.com/couple-on-sofa.jpg',
            'left_audio': 'https://cdn.example.com/left-question.mp3',
            'right_audio': 'https://cdn.example.com/right-answer.mp3',
            'order': 'left_right',
            'resolution': '480p',
            'prompt': 'Женщина слева говорит первой, радостно; мужчина справа молчит и слушает, потом отвечает с лёгкой усмешкой. Камера неподвижна',
        },
    },
    timeout=30,
)

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

Диалог в 720p

Сначала говорит человек справа, потом слева. Качество 720p стоит 12 ₽ за секунду.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "longcat-avatar-1-5-multi",
  "input": {
    "image": "https://cdn.example.com/podcast-hosts.png",
    "left_audio": "https://cdn.example.com/host-left.wav",
    "right_audio": "https://cdn.example.com/host-right.wav",
    "order": "right_left",
    "resolution": "720p"
  }
}'

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: 'longcat-avatar-1-5-multi',
    input: {
      image: 'https://cdn.example.com/podcast-hosts.png',
      left_audio: 'https://cdn.example.com/host-left.wav',
      right_audio: 'https://cdn.example.com/host-right.wav',
      order: 'right_left',
      resolution: '720p',
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'longcat-avatar-1-5-multi',
        'input': {
            'image': 'https://cdn.example.com/podcast-hosts.png',
            'left_audio': 'https://cdn.example.com/host-left.wav',
            'right_audio': 'https://cdn.example.com/host-right.wav',
            'order': 'right_left',
            'resolution': '720p',
        },
    },
    timeout=30,
)

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

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

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

Пример для дорожек длиной 4,3 и 3,1 секунды в 480p: каждая округляется вверх (5 и 4 секунды), вместе 9 секунд, 9 × 6 ₽ = 54 ₽.

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "longcat-avatar-1-5-multi",
  "cost": 54,
  "balance_after": 946,
  "created_at": "2026-09-30T21:34:50.418722+00:00"
}

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

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "longcat-avatar-1-5-multi",
  "cost": 54,
  "created_at": "2026-09-24T20:08:25.454000+00:00",
  "completed_at": "2026-09-24T20:16:42.553000+00:00",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/longcat-avatar-1-5-multi/dialog-1.mp4"
    ]
  },
  "error_message": null
}

Ответ при ошибке

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "longcat-avatar-1-5-multi",
  "cost": 54,
  "created_at": "2026-09-30T21:34:50.418722+00:00",
  "completed_at": "2026-09-30T21:37:26.51102+00:00",
  "result": null,
  "error_message": "Произошла ошибка, нейросеть временно недоступна. Попробуйте повторить запрос позже."
}

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

Сохраните id из ответа на создание и запрашивайте операцию, пока status не станет completed или failed:

GET /api/v1/operations/{id}

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

async function waitForOperation(id: string) {
  while (true) {
    const res = await fetch(`https://bratuha.ru/api/v1/operations/${id}`, {
      headers: { Authorization: 'Bearer brth_ваш_ключ' },
    })
    const op = await res.json()
    if (op.status === 'completed' || op.status === 'failed') return op
    await new Promise((resolve) => setTimeout(resolve, 15000))
  }
}

Нейросеть работает небыстро: диалог на 7-8 секунд в 480p готовился около восьми минут. Опрашивать одну операцию можно не чаще раза в секунду, иначе API ответит 429.

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

После завершения в поле result приходит видео:

{
  "type": "video",
  "urls": [
    "https://storage.bratuha.ru/results/longcat-avatar-1-5-multi/dialog-1.mp4"
  ]
}

• type - всегда "video".
• urls - массив ссылок на готовые видео. Для этой нейросети в нём одна ссылка на MP4.

Видео идёт со звуком обеих дорожек. В режиме по очереди ролик длится столько, сколько обе записи подряд: из дорожек на 4,3 и 3,1 секунды с left_right получилось видео на 7,6 секунды. Пропорции кадра берутся с фотографии: из горизонтального снимка 16:9 в 480p получилось видео 832×480, 25 кадров в секунду.

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

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

Цена зависит от качества и общей длины двух дорожек:

Как считается итог:

1. Сервер сам определяет длительность обеих записей по ссылкам. Передавать длительность в запросе не нужно.
2. Каждая дорожка округляется вверх до целых секунд отдельно: 4,3 секунды считаются как 5, 3,1 - как 4.
3. Округлённые длительности складываются: 5 + 4 = 9 секунд. Если сумма больше 64 секунд, в расчёт идут 64.
4. Сумма умножается на ставку выбранного качества.

Длины складываются при любом значении order, в том числе при meanwhile, когда дорожки звучат одновременно.

Примеры:

Фото, порядок речи и задание на цену не влияют. Итоговая сумма приходит в поле cost сразу в ответе на создание операции и списывается с баланса в этот момент. Если операция завершилась ошибкой, деньги возвращаются на баланс, а cost в ответе остаётся суммой запуска.

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

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию и списывает деньги заново.
• Операция выполняется асинхронно: сначала вы получаете queued, результат забираете по id.
• Файлы передаются только внешними http/https URL, доступными без авторизации, размером до 128 МБ. Для image - jpg, jpeg, png, webp, для left_audio и right_audio - mp3, wav, m4a, aac, flac, ogg, opus. Локальные адреса и приватные сети не принимаются.
• Рассчитывайте на диалог общей длиной до 64 секунд. Если по ссылке не удалось прочитать длительность хотя бы одной записи (например, файл повреждён), API сразу вернёт validation_error, операция не создастся и деньги не спишутся.
• На фото должно быть ровно два человека, лица хорошо видны. Дорожка left_audio достаётся тому, кто слева в кадре, right_audio - тому, кто справа.
• Для диалога по очереди готовьте дорожки без длинной тишины: каждая запись содержит только реплику своего человека. Тишина в начале и в конце записей тоже оплачивается.
• Чистая речь без музыки и шума даёт самую точную синхронизацию губ. Произносится только то, что есть в записях: задание меняет мимику и поведение, но не слова.