logo
RunComfy
  • ComfyUI
  • ТренерНовое
  • Модели
  • API
  • Цены
discord logo
МОДЕЛИ
Обзор
Все модели
БИБЛИОТЕКА
Генерации
API МОДЕЛЕЙ
Документация API
API-ключи
АККАУНТ
Использование

HeyGen Video: сцены преобразования текста в видео со звуком на Models and API | RunComfy

heygen/heygen-video/text-to-video

HeyGen Video превращает подсказку в короткий клип, изображение и звук которого генерируются вместе.

Содержание

1. Начало работы2. Аутентификация3. Справочник APIОтправить запросСтатус запросаПолучить результатыОтменить запрос4. Входные файлыРазмещённый файл (URL)5. СхемаСхема входаСхема выхода

1. Начало работы

Используйте API RunComfy для запуска heygen/heygen-video/text-to-video. Допустимые входы и выходы см. в схеме.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/heygen/heygen-video/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A woman in a plain navy coat stands on a wet cobblestone street at dusk, holding a paper cup. Shot on a 50mm lens, locked on a tripod, with warm light from a bakery window behind her. She looks just past the camera and says, calmly: The last tram leaves at nine. Street ambience only, no music, no logos, and no printed words anywhere in frame."
  }'

2. Аутентификация

Задайте для переменной окружения YOUR_API_TOKEN ваш API-ключ (управление в Профиль) и передавайте в каждом запросе Bearer-токен в заголовке Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Справочник API

Отправить запрос

Отправьте асинхронную задачу генерации и сразу получите request_id и URL для статуса, результатов и отмены.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/heygen/heygen-video/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A woman in a plain navy coat stands on a wet cobblestone street at dusk, holding a paper cup. Shot on a 50mm lens, locked on a tripod, with warm light from a bakery window behind her. She looks just past the camera and says, calmly: The last tram leaves at nine. Street ambience only, no music, no logos, and no printed words anywhere in frame."
  }'

Статус запроса

Текущее состояние по request_id: «in_queue», «in_progress», «completed» или «cancelled».

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Получить результаты

Финальные выходные данные и метаданные для request_id; если задача не завершена, в ответе — текущее состояние для дальнейшего опроса.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Отменить запрос

Отмена задачи в очереди по request_id; выполняющиеся задачи отменить нельзя.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Входные файлы

Размещённый файл (URL)

Укажите публично доступный HTTPS URL. Хост должен разрешать серверные запросы (без входа и cookie), без жёсткого лимита и блокировки ботов. Рекомендуется: изображения ≤ 50 МБ (~4K), видео ≤ 100 МБ (~2–5 мин при 720p). Для приватных ресурсов — стабильные или подписанные URL.

5. Схема

Схема входа

{
  "type": "object",
  "title": "Схема входа",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Промпт",
      "description": "Сюжет, место, камера, диалоги и звук в одном кадре.",
      "type": "string",
      "maxLength": 32000,
      "default": "A woman in a plain navy coat stands on a wet cobblestone street at dusk, holding a paper cup. Shot on a 50mm lens, locked on a tripod, with warm light from a bakery window behind her. She looks just past the camera and says, calmly: The last tram leaves at nine. Street ambience only, no music, no logos, and no printed words anywhere in frame."
    },
    "duration": {
      "title": "Длительность",
      "description": "Длина клипа в целых секундах.",
      "type": "integer",
      "default": 5,
      "minimum": 5,
      "maximum": 15
    },
    "resolution": {
      "title": "Разрешение",
      "description": "Размер кадра. 1080p и 2k поддерживают только 16:9 и 9:16.",
      "type": "string",
      "enum": [
        "480p",
        "768p",
        "1080p",
        "2k"
      ],
      "default": "768p"
    },
    "aspect_ratio": {
      "title": "Соотношение сторон",
      "description": "Форма рамки. 1080p и 2k поддерживают только 16:9 и 9:16.",
      "type": "string",
      "enum": [
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "16:9"
    },
    "prompt_enhancement": {
      "title": "Быстрое улучшение",
      "description": "Насколько далеко расширяется подсказка перед выстрелом. Отключено сохраняет текст в том виде, в котором он написан.",
      "type": "string",
      "enum": [
        "turbo",
        "quality",
        "ultraquality",
        "disabled"
      ],
      "default": "quality"
    },
    "seed": {
      "title": "Seed",
      "description": "Дополнительная ручка повтора. Оставьте пустым, чтобы позволить службе выбирать.",
      "type": "integer",
      "minimum": 0,
      "maximum": 4294967295
    }
  }
}

Схема выхода

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL одного изображения"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL одного видео"
      },
      "images": {
        "type": "array",
        "description": "несколько URL изображений",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "несколько URL видео",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Подписывайтесь на нас
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Поддержка
  • Discord
  • Email
  • Статус системы
  • партнёр
Модели видео
  • OmniHuman 2.0
  • Wan 2.5
  • Wan 3.0
  • MiniMax H3 Max
  • Wan 2.6 Flash
  • Seedance 2.5 Reference to Video 1080p
  • Посмотреть все модели →
Модели изображений
  • Wan 2.6 Image to Image
  • Nano Banana 2.1 Edit
  • Flux 2 Max Edit
  • Seedream 5.0 Pro
  • Nano Banana Pro
  • GPT Image 2.5 Sunburst
  • Посмотреть все модели →
Юридическая информация
  • Условия обслуживания
  • Политика конфиденциальности
  • Политика в отношении файлов cookie
RunComfy
Авторское право 2026 RunComfy. Все права защищены.

RunComfy - ведущая ComfyUI платформа, предлагающая ComfyUI онлайн среду и услуги, а также рабочие процессы ComfyUI с потрясающей визуализацией. RunComfy также предоставляет AI Models, позволяя художникам использовать новейшие инструменты AI для создания невероятного искусства.