---
title: &quot;在爱马仕 (Hermes Agent) 中通过 RunAPI 使用 InfiniteTalk — 口型同步头像 API 指南&quot;
url: &quot;https://runapi.ai/zh-CN/hermes-infinitetalk.md&quot;
canonical: &quot;https://runapi.ai/zh-CN/hermes-infinitetalk&quot;
locale: &quot;zh-CN&quot;
model: &quot;infinitetalk&quot;
---

# 在 Hermes Agent 中使用 InfiniteTalk。

InfiniteTalk 根据音频文件和人脸图像生成口型同步的说话头像视频。Hermes Agent 通过 RunAPI custom 端点调用它——配置一次 custom:runapi，发送 audio_to_video，轮询获取完成的视频。

## API example

```bash
curl -X POST https://runapi.ai/api/v1/infinitetalk/audio_to_video \
  -H &quot;Authorization: Bearer $RUNAPI_API_KEY&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d &#39;{
    &quot;model&quot;: &quot;infinitetalk-from-audio&quot;,
    &quot;source_audio_url&quot;: &quot;https://example.com/speech.mp3&quot;,
    &quot;source_image_url&quot;: &quot;https://example.com/avatar.jpg&quot;,
    &quot;prompt&quot;: &quot;A professional presenter delivering a product overview&quot;
  }&#39;

```

### Response

```json
{
  &quot;task_id&quot;: &quot;tsk_abc123&quot;,
  &quot;status&quot;: &quot;pending&quot;,
  &quot;model&quot;: &quot;infinitetalk-from-audio&quot;
}

```

## How it works

1. **配置 RunAPI** — 在运行 Hermes Agent 的环境中设置 RUNAPI_API_KEY。如果你已经添加了 RunAPI 作为 custom:runapi provider，同一个 key 也可以处理 InfiniteTalk 请求。
2. **调用 InfiniteTalk** — 向 audio_to_video 端点发送 POST 请求，包含 model、音频 URL、图像 URL 和描述输出的 prompt。Hermes Agent 可以通过 custom:runapi provider 构建并发送此请求。
3. **轮询结果** — 端点立即返回 task_id。轮询任务状态端点，直到状态为 completed，然后从响应中读取输出视频 URL。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。使用 infinitetalk-from-audio。 |
| `source_audio_url` | `string` | 必填。用于口型同步的源音频文件 URL。 |
| `source_image_url` | `string` | 必填。用于动画化的人脸或头像图像 URL。 |
| `prompt` | `string` | 必填。对所需视频输出的文字描述，最多 5000 个字符。 |
| `output_resolution` | `string` | 可选。输出视频分辨率。可选值：480p、720p，默认 480p。 |
| `seed` | `integer` | 可选。可复现性种子。10000 到 1000000 之间的整数。 |
| `callback_url` | `string` | 可选。任务完成时接收 POST 的 webhook URL。 |

## FAQ

### 可以在 Hermes Agent 中使用 InfiniteTalk 吗？

可以。Hermes Agent 可以通过 custom:runapi provider 调用 RunAPI InfiniteTalk 端点。在环境中设置 RUNAPI_API_KEY，然后向 /api/v1/infinitetalk/audio_to_video 发送 POST 请求，包含 model、音频 URL 和图像 URL。

### InfiniteTalk 需要单独的 API key 吗？

不需要。用于聊天、图像和视频生成的同一个 RUNAPI_API_KEY 也适用于 InfiniteTalk。所有 RunAPI 模型共享一个 key 和一个点数余额。

### InfiniteTalk 是同步还是异步的？

异步。创建端点立即返回 task_id。轮询任务状态端点，或提供 callback_url 以在视频准备好时接收 webhook。

### 在 RunAPI 上使用 InfiniteTalk 的价格是多少？

InfiniteTalk 按任务计费。查看 RunAPI 定价页面获取最新价格。点数从所有 RunAPI 模型共用的同一余额中扣除。


## Links

- [Hermes Agent 配置指南 →](https://runapi.ai/zh-CN/hermes-agent)
- [RunAPI 上的 InfiniteTalk →](https://runapi.ai/zh-CN/models/infinitetalk)
- [Model catalog](https://runapi.ai/zh-CN/models)
- [API docs](https://runapi.ai/zh-CN/docs)
