음성 생성
성공적인 응답은 JSON이 아닌 바이너리 오디오입니다.
이 페이지에서
https://api.shareai.now/api/v1/audio/speech음성 생성
- 기본 URL
https://api.shareai.now- 인증
- Bearer API 키 또는 승인된 OAuth 액세스 토큰
- 필수 범위
inferenceormonetization_gateway
성공적인 응답은 JSON이 아닌 바이너리 오디오입니다. 저장하려면 curl --output speech.mp3 또는 SDK에서 응답 바이트를 읽으세요. 지원되는 모델 음성과 출력 형식을 선택하세요. 속도는 0.25에서 4까지 제한됩니다. 입력 한도는 256 KiB이며 동기 응답 한도는 2 MiB입니다.
시작하기 전에#
서버에서 SHAREAI_API_KEY를 설정하고 모델 자리 표시자를 현재 활성화된 모델로 교체하세요. API 키를 브라우저 코드에 노출하지 마세요. 모델, 계정, 자격 증명 및 제공자가 모두 이 작업을 허용해야 합니다. 아래의 선택적 설정은 모델 지원이 필요합니다. API 안전 한도는 모든 모델이 모든 값을 지원한다는 보장이 아닙니다.
요청 보내기#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}' --output speech.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));요청 필드#
| 필드 | 유형 | 의미와 제한 |
|---|---|---|
model 필수 | 문자열 | 정확히 활성화된 공개 모델 식별자. 이 작업을 선언하고 귀하의 자격 증명으로 허용되어야 합니다. |
input 필수 | 문자열 | 필수 비어 있지 않은 음성 텍스트, 최대 256 KiB의 UTF-8. 문자 요금은 인코딩된 바이트가 아닌 유니코드 문자를 기준으로 계산됩니다. |
voice | 문자열 | 선택적으로 지원되는 음성 모델에서 지원하는 음성, 최대 100자. |
response_format | 문자열 | mp3와 같은 선택적으로 지원되는 오디오 인코딩. 성공적인 응답은 JSON이 아닌 바이너리입니다. 지속 시간 기반 경로는 자체 설명 MP3, WAV 또는 FLAC이 필요합니다. |
speed | 숫자 | 선택적으로 0.25에서 4까지의 음성 속도; 모델에 따라 더 좁은 제한이 있을 수 있습니다. |
provider | 객체 | 선택적 공급자 라우팅 선호도. 모델 ID의 접두사가 아닌, 허용된 공급자 태그에 대해 provider.only를 사용하십시오. 계정 및 자격 증명 제한은 여전히 적용됩니다. |
결과 읽기#
성공 시 HTTP 200과 바이너리 오디오를 반환합니다. 성공적인 응답은 JSON이 아닌 바이너리 오디오입니다. 저장하려면 curl --output speech.mp3 또는 SDK에서 응답 바이트를 읽으세요. 지원되는 모델 음성과 출력 형식을 선택하세요. 속도는 0.25에서 4까지 제한됩니다. 입력 한도는 256 KiB이며 동기 응답 한도는 2 MiB입니다.
청구 단위#
음성은 입력 문자, 제공자가 보고한 토큰 또는 생성된 초 단위로 가격이 책정될 수 있으며, 이는 모델에 따라 다릅니다. 문자 수는 유니코드 문자를 기준으로 계산됩니다. 지속 시간 가격 책정은 지원되는 자체 설명 MP3, WAV 또는 FLAC 결과가 필요합니다. 원시 PCM 결과에는 추정된 샘플 속도가 없습니다. 토큰 가격 경로는 신뢰할 수 있는 사용 영수증이 필요합니다.
Console에서 정확히 활성화된 모델 식별자를 선택하세요. 선언된 작업 및 입출력 기능이 이 엔드포인트와 일치해야 합니다. 텍스트 채팅 모델은 다른 작업으로 대체될 수 없습니다. 자격 증명, 제공자 및 계정 제한은 여전히 적용됩니다.
가격 및 사용량#
요금은 선택된 모델, 제공자, 단위 및 변형에 대해 EUR AI 크레딧으로 게시됩니다. 활성 요금제의 차원만 청구됩니다. 실행 전에 크레딧을 예약하는 견적이 제공되며, 최종 청구는 측정된 사용량을 기준으로 합니다. 가격은 해상도, 출력 형식 또는 사용량 대역에 따라 달라질 수 있습니다. 최종 ShareAI 차감액은 Console Usage에서 확인하세요. 상류 비용 필드와 미디어 바이트는 발명된 토큰 수로 변환되지 않습니다.
접근 및 오류#
사용 inference 승인된 네트워크 비용 추론의 경우 monetization_gateway 승인된 Builder 마크업 및 수락된 청구 조건의 경우. 신원 확인만으로는 지출이 승인되지 않습니다. 유효성 검사, 모델 승인, 크레딧 부족, 속도 제한 및 실행 실패는 구조화된 error. 를 반환합니다. 타임아웃 또는 불확실한 제출 후에는 또 다른 잠재적으로 유료 요청을 생성하기 전에 Usage 또는 비디오 작업을 확인하세요.
마지막 업데이트 2026년 11월 3일