Bytedance · Video

Hermes Agent x Volcengine Lip Sync

Volcengine Lip Sync provides a focused video-to-video lip-sync endpoint through RunAPI with unified API, SDK, CLI, Bruno, and docs coverage.

1 variants from $0.08 / second Commercial OK

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use volcengine-lip-sync when it matches the task: Audio-driven video-to-video lip sync from source video and audio.

You have access to RunAPI task tools for Volcengine Lip Sync.

Available Volcengine Lip Sync models:
- volcengine-lip-sync: Audio-driven video-to-video lip sync from source video and audio
  endpoints: /api/v1/volcengine_lip_sync/lip_sync_video
  request fields: model, mode, source_video_url, source_audio_url

Use the model ID and endpoint that match the user's request.
Example prompt: Lip-sync this presenter video to the uploaded narration while keeping the original framing and motion.
/api/v1/volcengine_lip_sync/lip_sync_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/volcengine_lip_sync/lip_sync_video and save the returned Task id.
GET /api/v1/volcengine_lip_sync/lip_sync_video/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Public Versions and Endpoints

Model ID Endpoints Price Catalog
volcengine-lip-sync
/api/v1/volcengine_lip_sync/lip_sync_video
$0.08 / second Model detail

Verify

Poll until the task reaches a terminal status

POST /api/v1/volcengine_lip_sync/lip_sync_video and save the returned Task id.
GET /api/v1/volcengine_lip_sync/lip_sync_video/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Configuration

Guide endpoint: /api/v1/volcengine_lip_sync/lip_sync_video

export RUNAPI_API_KEY=your_api_key

curl -X POST https://runapi.ai/api/v1/volcengine_lip_sync/lip_sync_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "volcengine-lip-sync",
  "mode": "lite",
  "source_video_url": "https://file.runapi.ai/source-video.mp4",
  "source_audio_url": "https://file.runapi.ai/narration.mp3"
}'
How it works

Get Started in 3 Steps

  1. Choose a model ID

    Select a public catalog model ID and review its endpoint and current starting price.

  2. Configure RunAPI

    Set RUNAPI_API_KEY before making the endpoint request.

  3. Verify the result

    For asynchronous endpoints, poll the same endpoint until the Task reaches a terminal status.

What to Build with Hermes Agent + Volcengine Lip Sync

  • Product and marketing clips

    Create short promotional clips for product pages, ads, and landing pages from a written brief.

  • Social media shorts

    Produce short clips for social feeds and try several takes of the same idea before choosing one.

  • Image animation and video edits

    Animate still images or change existing footage where the model offers image-to-video or video editing endpoints.

Why Use Volcengine Lip Sync Through RunAPI + Hermes Agent

  • 1 variants, one API key

    Use one RunAPI connection to choose among the live model variants without changing your integration.

  • Clear usage pricing

    See current catalog pricing before you send a request, with no subscription or minimum spend required.

  • Automatic task workflows

    Submit, poll, and collect asynchronous results through a consistent task workflow without writing manual polling code.

Hermes Agent + Volcengine Lip Sync Questions

What inputs does Volcengine Lip Sync require?

It requires one public source video URL and one public source audio URL.

Which mode should I choose?

Use `lite` for frontal single-person videos and faster processing. Use `basic` when the scene is more complex and you need scene detection.

What does `enable_vocal_separation` do?

It suppresses background noise by separating vocals before driving the lip movement.

When can I use `align_audio`?

`align_audio`, `align_audio_reverse`, and `template_start_seconds` are available in `lite` mode only.

What does the completed response return?

The completed response returns generated video URLs in `videos`.

Which model ID should I use?

Choose a public model ID from the version table. Each ID exposes the endpoints shown for that version.

Does this guide configure a chat model?

No. This Model Line uses the endpoint workflow shown here and is not presented as an agent chat model.

Start using Volcengine Lip Sync with Hermes Agent

Building with a team?

We're here to help with enterprise setup, integrations, and technical questions.

Contact Us