批量视频请求
本 API 指南概述了批量请求生成。
批量视频请求
批量请求允许您使用包含用户特定数据的 CSV 文件一次性生成多个个性化视频文件。 您不必单独创建每个音频，而是可以将姓名和公司详细信息等各种字段输入 CSV，系统将自动为每个条目生成定制的音频。 🦊 假设您想为多个用户创建个性化音频文件。 您的 CSV 文件包含以下数据：
| 名字 | 公司名称 |
|---|---|
| 约翰 | Acme Corp |
| 简 | Beta Ltd |
现在，在您的音频文本中，您可以使用支持的宏，如下所示： "您好 {{First Name}}，欢迎来到 {{Company Name}}！" 处理批量请求时，宏将替换为 CSV 中的值。生成的音频将是：
- "你好 John Smith，欢迎来到 Acme Corp！"
- "你好 Jane Doe，欢迎来到 Beta Ltd！"
这样，您就可以在 CSV 中为每个用户创建自定义音频文件，使批量请求既高效又个性化。
快速入门
让我们深入了解如何使用自定义配置创建批量请求。## 创建批量请求 要创建批量请求，请使用以下 API 请求。它允许您定义各种设置，包括音频文本、头像和背景，以生成批量请求。自定义参数以满足您的需要。如果您有一个批量模板，要使用它来创建批量请求，请使用创建批量模板 API。您可以从音频列表 API中获取"audio_id"和"audio_service"，从csv 列表 API中获取"csv_id"。您可以在 'audio_text' 中使用 '{{}}' 格式的宏，这些宏将由您提供的 CSV 文件中的值动态替换。例如，如果您在文本中包含 '{{First Name}}'，它将被 CSV 中每个相应条目的名称（如"John"和"Smith"）替换，从而为列表中的每个视频创建个性化音频。我们支持每个请求最多 20 个模板变量。请确保您的文本和 CSV 文件中这些变量的数量和名称完全匹配。模板变量文本不区分大小写。如果 CSV 中缺少任何模板变量，则会返回错误。在响应中，您将收到有关成功视频数量和失败视频数量的详细信息。使用响应中的 'id' 使用 批量状态 API 检查批量请求的状态
- 'id'：批量请求的标识符。
- 'successful_requests_count'：成功发送处理的视频数量。
- 'failed_requests_count'：未能处理的视频数量。
curl --request POST \
--url 'https://api.immersive-fox.com/v1/bulk_requests/generate_video/' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: application/json' \
--data { \
"csv_id": 45 \
"subtitles_flag": false \
"video_name": "My First Video" \
"configurations": [ \
{ \
"audio_text": "Hi, My name is {{First Name}}", \
"avatar": 102, \
"avatar_size": 76, \
"background_color": "#ffffff", \
"background_music_is_personalized": "system", \
"background_music_volume": 0.1, \
"frame_height": 1080, \
"frame_width": 1920, \
"is_personalized_audio": false, \
"scene_number": 1, \
"scene_transition": "none", \
"audio_id": 2, \
"audio_service": "google_audio", \
"user_voice_speed": 1, \
"x_position": 0.604931, \
"y_position": 0.43101 \
} \
] \
}
{
"id": 178,
"message": "Requests Created",
"successful_requests_count": 3,
"failed_requests_count": 0,
"failed_requests": []
}