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"
}
{
"success": false,
"message": "Audio too large. Maximum size is 50MB"
}
파일 업로드
오디오 업로드
오디오 파일을 업로드하고 오디오 관련 API에서 사용할 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"
}
{
"success": false,
"message": "Audio too large. Maximum size is 50MB"
}
중국 본토 사용자 안내: 중국 본토 사용자는
https://toapis.cn 을 API 엔드포인트 (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
업로드 목적 (선택 사항)기본값:
generation응답
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"
}
{
"success": false,
"message": "Audio too large. Maximum size is 50MB"
}