curl --request POST \
--url https://toapis.com/v1/uploads/audios \
--header 'Authorization: Bearer <token>' \
--form 'file=@/path/to/your/audio.mp3'
import requests
with open('audio.mp3', 'rb') as f:
response = requests.post(
"https://toapis.com/v1/uploads/audios",
headers={
"Authorization": "Bearer your-ToAPIs-key"
},
files={
"file": f
}
)
result = response.json()
audio_url = result['data']['url']
print(f"音频 URL: {audio_url}")
(async () => {
const fileInput = document.createElement('input');
fileInput.type = 'file';
fileInput.accept = 'audio/mpeg,audio/wav,audio/mp4';
fileInput.click();
await new Promise(resolve => fileInput.onchange = resolve);
const formData = new FormData();
formData.append('file', fileInput.files[0]);
const uploadResponse = await fetch('https://toapis.com/v1/uploads/audios', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key'
},
body: formData
});
const uploadResult = await uploadResponse.json();
console.log('上传结果:', uploadResult);
})();
{
"success": true,
"message": "",
"data": {
"id": "upload_abc12345",
"url": "https://files.toapis.com/uploads/123/audios/1737568800_abc12345.mp3",
"mime_type": "audio/mpeg",
"size": 1892345
}
}
{
"success": false,
"message": "Unsupported or invalid audio file. Allowed: MP3, WAV, M4A"
}
文件上传
上传音频
上传音频获取 URL,用于音频相关接口或其他需要音频 URL 的接口
POST
/
v1
/
uploads
/
audios
curl --request POST \
--url https://toapis.com/v1/uploads/audios \
--header 'Authorization: Bearer <token>' \
--form 'file=@/path/to/your/audio.mp3'
import requests
with open('audio.mp3', 'rb') as f:
response = requests.post(
"https://toapis.com/v1/uploads/audios",
headers={
"Authorization": "Bearer your-ToAPIs-key"
},
files={
"file": f
}
)
result = response.json()
audio_url = result['data']['url']
print(f"音频 URL: {audio_url}")
(async () => {
const fileInput = document.createElement('input');
fileInput.type = 'file';
fileInput.accept = 'audio/mpeg,audio/wav,audio/mp4';
fileInput.click();
await new Promise(resolve => fileInput.onchange = resolve);
const formData = new FormData();
formData.append('file', fileInput.files[0]);
const uploadResponse = await fetch('https://toapis.com/v1/uploads/audios', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key'
},
body: formData
});
const uploadResult = await uploadResponse.json();
console.log('上传结果:', uploadResult);
})();
{
"success": true,
"message": "",
"data": {
"id": "upload_abc12345",
"url": "https://files.toapis.com/uploads/123/audios/1737568800_abc12345.mp3",
"mime_type": "audio/mpeg",
"size": 1892345
}
}
{
"success": false,
"message": "Unsupported or invalid audio file. Allowed: MP3, WAV, M4A"
}
国内用户请注意: 中国大陆用户请使用
https://toapis.cn 作为接口地址 (Base URL).文档示例中的 https://toapis.com 请替换为 https://toapis.cn.文档 Playground 不支持文件上传:请使用下方的 cURL,Python 或 JavaScript 代码示例进行测试.
为什么需要先上传音频?
- 统一输入方式 - 本地音频先上传成公网 URL, 便于后续接口复用
- 减少重复传输 - 上传一次后可以在多个请求中重复使用
Authorizations
string
必填
Body
file
必填
音频文件支持的格式:
- MP3 (.mp3)
- WAV (.wav)
- M4A (.m4a)
- 最大文件大小: 50MB
string
上传目的 (可选)默认值:
generationResponse
boolean
请求是否成功
object
curl --request POST \
--url https://toapis.com/v1/uploads/audios \
--header 'Authorization: Bearer <token>' \
--form 'file=@/path/to/your/audio.mp3'
import requests
with open('audio.mp3', 'rb') as f:
response = requests.post(
"https://toapis.com/v1/uploads/audios",
headers={
"Authorization": "Bearer your-ToAPIs-key"
},
files={
"file": f
}
)
result = response.json()
audio_url = result['data']['url']
print(f"音频 URL: {audio_url}")
(async () => {
const fileInput = document.createElement('input');
fileInput.type = 'file';
fileInput.accept = 'audio/mpeg,audio/wav,audio/mp4';
fileInput.click();
await new Promise(resolve => fileInput.onchange = resolve);
const formData = new FormData();
formData.append('file', fileInput.files[0]);
const uploadResponse = await fetch('https://toapis.com/v1/uploads/audios', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key'
},
body: formData
});
const uploadResult = await uploadResponse.json();
console.log('上传结果:', uploadResult);
})();
{
"success": true,
"message": "",
"data": {
"id": "upload_abc12345",
"url": "https://files.toapis.com/uploads/123/audios/1737568800_abc12345.mp3",
"mime_type": "audio/mpeg",
"size": 1892345
}
}
{
"success": false,
"message": "Unsupported or invalid audio file. Allowed: MP3, WAV, M4A"
}