오디오 생성
ShareAI 엔드포인트는 제한된 JSON 오디오 결과를 반환합니다.
이 페이지에서
https://api.shareai.now/api/v1/audio/generations오디오 생성
- 기본 URL
https://api.shareai.now- 인증
- Bearer API 키 또는 승인된 OAuth 액세스 토큰
- 필수 범위
inferenceormonetization_gateway
ShareAI 엔드포인트는 제한된 JSON 오디오 결과를 반환합니다. 오디오 생성 요청은 modalities:["text","audio"] 또한 사용할 수 있습니다 /api/v1/chat/completions. 요청은 선언된 오디오 작업으로 라우팅됩니다. 이 동기 응답은 반환 전에 수집되며, 불완전한 Provider 스트림은 성공적으로 청구된 결과로 간주되지 않습니다. 오디오 출력 형식은 모델에 따라 mp3, wav, flac, pcm16 또는 pcm24입니다. Raw PCM은 지속 시간 요금을 지원하지 않습니다. 생성된 토큰을 제한하려면 max_tokens 또는 max_completion_tokens 중 하나를 설정하세요. 둘 다 제공하지 마세요.
시작하기 전에#
서버에서 SHAREAI_API_KEY를 설정하고 모델 자리 표시자를 현재 활성화된 모델로 교체하세요. API 키를 브라우저 코드에 노출하지 마세요. 모델, 계정, 자격 증명 및 제공자가 모두 이 작업을 허용해야 합니다. 아래의 선택적 설정은 모델 지원이 필요합니다. API 안전 한도는 모든 모델이 모든 값을 지원한다는 보장이 아닙니다.
요청 보내기#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_AUDIO_MODEL',
'messages': [{'role': 'user', 'content': 'A short instrumental melody.'}],
'modalities': ['text', 'audio'],
'audio': {'format': 'mp3'},
'max_completion_tokens': 1024}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/generations', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/generations", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);요청 필드#
| 필드 | 유형 | 의미와 제한 |
|---|---|---|
model 필수 | 문자열 | 정확히 활성화된 공개 모델 식별자. 이 작업을 선언하고 귀하의 자격 증명으로 허용되어야 합니다. |
messages 필수 | 배열 | 역할/내용이 포함된 1–256개의 대화 메시지. 선택한 오디오 모델이 지원하는 콘텐츠 모달리티만 사용하세요. |
modalities | 배열 | 텍스트와 오디오 중 하나 또는 두 개의 고유 값; 오디오는 필수입니다. 기본값은 오디오입니다. 이 동기 엔드포인트는 스트림을 허용하지 않습니다. |
audio | 객체 | 선택적 출력 옵션: voice와 format만. format은 모델 지원에 따라 mp3, wav, flac, pcm16 또는 pcm24입니다. Raw PCM은 지속 시간 요금과 호환되지 않습니다. |
temperature | 숫자 | 선택적 모델 지원 생성 온도. |
top_p | 숫자 | 선택적 모델 지원 누클리어스 샘플링 값. |
max_tokens | 정수 | 선택적 출력 토큰 제한, 1–262144. max_completion_tokens와 함께 사용하지 마세요. |
max_completion_tokens | 정수 | 선택적 출력 토큰 제한, 1–262144. max_tokens와 함께 사용하지 마세요. |
provider | 객체 | 선택적 공급자 라우팅 선호도. 모델 ID의 접두사가 아닌, 허용된 공급자 태그에 대해 provider.only를 사용하십시오. 계정 및 자격 증명 제한은 여전히 적용됩니다. |
결과 읽기#
성공 시 HTTP 200과 JSON을 반환합니다. ShareAI 엔드포인트는 제한된 JSON 오디오 결과를 반환합니다. 오디오 생성 요청은 modalities:["text","audio"] 또한 사용할 수 있습니다 /api/v1/chat/completions. 요청은 선언된 오디오 작업으로 라우팅됩니다. 이 동기 응답은 반환 전에 수집되며, 불완전한 Provider 스트림은 성공적으로 청구된 결과로 간주되지 않습니다. 오디오 출력 형식은 모델에 따라 mp3, wav, flac, pcm16 또는 pcm24입니다. Raw PCM은 지속 시간 요금을 지원하지 않습니다. 생성된 토큰을 제한하려면 max_tokens 또는 max_completion_tokens 중 하나를 설정하세요. 둘 다 제공하지 마세요.
청구 단위#
오디오 모델은 별도의 텍스트 토큰 및 오디오 토큰 차원, 지속 시간, 노래 또는 요청 속도를 게시할 수 있습니다. 포함된 토큰 총계는 분리된 텍스트/오디오 카운터로 나뉘며, 동일한 오디오 토큰은 텍스트로 다시 청구되지 않습니다. 지원되지 않거나 누락된 사용량은 인코딩된 바이트에서 추정되지 않습니다.
Console에서 정확히 활성화된 모델 식별자를 선택하세요. 선언된 작업 및 입출력 기능이 이 엔드포인트와 일치해야 합니다. 텍스트 채팅 모델은 다른 작업으로 대체될 수 없습니다. 자격 증명, 제공자 및 계정 제한은 여전히 적용됩니다.
가격 및 사용량#
요금은 선택된 모델, 제공자, 단위 및 변형에 대해 EUR AI 크레딧으로 게시됩니다. 활성 요금제의 차원만 청구됩니다. 실행 전에 크레딧을 예약하는 견적이 제공되며, 최종 청구는 측정된 사용량을 기준으로 합니다. 가격은 해상도, 출력 형식 또는 사용량 대역에 따라 달라질 수 있습니다. 최종 ShareAI 차감액은 Console Usage에서 확인하세요. 상류 비용 필드와 미디어 바이트는 발명된 토큰 수로 변환되지 않습니다.
접근 및 오류#
사용 inference 승인된 네트워크 비용 추론의 경우 monetization_gateway 승인된 Builder 마크업 및 수락된 청구 조건의 경우. 신원 확인만으로는 지출이 승인되지 않습니다. 유효성 검사, 모델 승인, 크레딧 부족, 속도 제한 및 실행 실패는 구조화된 error. 를 반환합니다. 타임아웃 또는 불확실한 제출 후에는 또 다른 잠재적으로 유료 요청을 생성하기 전에 Usage 또는 비디오 작업을 확인하세요.
마지막 업데이트 2026년 11월 3일