同步语音克隆

适合短文本（小于500字符）的语音克隆，立即返回结果。

请求信息

方法: POST
端点: /api/instant/clone-sync
内容类型: multipart/form-data 或 application/json

请求参数

参数	类型	必需	描述
`audio`	文件 (二进制)	是*	用于语音克隆的音频文件。支持的格式包括 WAV、MP3 和 M4A。仅支持 multipart/form-data 格式。您必须提供 `audio` 或 `audio_url` 之一。
`audio_url`	string	是*	用于语音克隆的公开可访问的音频文件 URL (WAV, MP3, M4A)。支持 multipart/form-data 和 application/json 两种格式。您必须提供 `audio` 或 `audio_url` 之一。
`text`	string	是	您希望以克隆语音合成的文本。
`api_key`	string	是	您的唯一 API 密钥，用于认证和访问。此密钥用于验证您的请求并将其链接到您的用户帐户。
`type`	int	是	1. 返回流媒体 2. 返回一个可播放的audio_url（24小时有效）
`speed_ratio`	float	否	语速比例，范围 0.5-2.0，默认值为 1.0
`pitch_ratio`	float	否	音调偏移，范围 -10 到 10 半音，默认值为 0
`volume_ratio`	float	否	音量比例，范围 0.1-2.0，默认值为 1.0

*注意：

audio 和 audio_url 参数二选一，至少提供其中一个
使用 application/json 格式时，只能使用 audio_url 参数
使用 multipart/form-data 格式时，两个参数都支持

响应

成功响应

返回类型: 根据 type 参数返回流媒体或 audio_url


{
    "audio_url": "https://pub-86e8fdaa1c484bfb856e9d0f2cf54e2a.r2.dev/1748152296147_89ce52d0_voice_clone_sync_b5f0ff03.mp3"
}

错误响应

400 Bad Request: 缺少必需参数（例如 api_key，或 audio/audio_url 均未提供）

示例请求

使用音频文件


curl -X POST https://aivoiceclonefree.com/api/instant/clone-sync \
  -F "[email protected]" \
  -F "text=Hello, this is a test message" \
  -F "api_key=your_api_key_here" \
  -F "type=2"

使用音频URL


curl -X POST https://aivoiceclonefree.com/api/instant/clone-sync \
  -F "audio_url=https://example.com/sample.mp3" \
  -F "text=Hello, this is a test message" \
  -F "api_key=your_api_key_here" \
  -F "type=2"

使用音频处理参数


curl -X POST https://aivoiceclonefree.com/api/instant/clone-sync \
  -F "[email protected]" \
  -F "text=Hello, this is a test message" \
  -F "api_key=your_api_key_here" \
  -F "type=2" \
  -F "speed_ratio=1.2" \
  -F "pitch_ratio=2" \
  -F "volume_ratio=1.5"

使用 JSON 格式（配合 audio_url）


curl -X POST https://aivoiceclonefree.com/api/instant/clone-sync \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://example.com/sample.mp3",
    "text": "Hello, this is a test message",
    "api_key": "your_api_key_here",
    "type": 2,
    "speed_ratio": 1.2,
    "pitch_ratio": 2,
    "volume_ratio": 1.5
  }'

使用说明

文本长度限制: 适合小于500字符的短文本
音频格式: 支持 WAV、MP3、M4A 格式
请求格式:
- 使用 multipart/form-data: 可以直接上传音频文件（audio 参数）或使用音频URL（audio_url 参数）
- 使用 application/json: 只能使用音频URL（audio_url 参数）
返回类型:
- type=1: 返回音频流
- type=2: 返回音频文件URL（24小时有效）
响应时间: 通常在几秒内返回结果