aisplice

API 레퍼런스

오디오

아직 지원하는 모델이 없습니다

현재 모델 목록에서 이 경로를 지원하는 모델이 없습니다. 이 페이지는 참고용으로 남겨 둡니다.
POST/v1/audio/speech
POST/v1/audio/transcriptions
POST/v1/audio/translations

음성 양방향: /v1/audio/speech는 텍스트를 오디오 바이트로 합성하고, /v1/audio/transcriptions는 오디오를 텍스트로 변환하며(Whisper 호환), /v1/audio/translations는 바로 영어로 전사합니다.

#요청 파라미터

  • modelstring필수

    speech에는 tts-1 계열, 전사에는 whisper-1 계열.

  • inputstring필수

    speech 전용: 읽어 줄 텍스트.

  • voicestring필수

    speech 전용: 음성 이름(alloy, nova, …). 사용 가능한 음성은 모델 카드를 참고하세요.

  • filefile (multipart)필수

    transcriptions 전용: 오디오 파일(mp3, wav, m4a, webm …).

  • languagestring선택

    transcriptions 전용: 정확도를 높이는 ISO-639-1 언어 힌트.

  • response_formatstring선택

    speech: mp3 | wav | opus …; transcriptions: json | text | srt | verbose_json.

  • speednumber선택

    speech 전용: 재생 속도 0.25–4.0.

서로 다른 두 가지 Content-Type

speech는 JSON 본문을 받아 원시 오디오 바이트를 반환하고, transcriptions/translations는 multipart/form-data를 받아 JSON을 반환합니다. 둘을 섞지 마세요.

#관련 오류

  • 413 payload_too_large요청 본문(프롬프트, 이미지 또는 오디오 파일)이 허용 크기를 넘었습니다.
  • 401Bearer 토큰이 유효하지 않거나 없습니다. 이 경로에는 error.code가 없으므로 상태 코드로 판단하세요.
  • 402 insufficient_user_quota지갑 잔액이 사전 차감 추정액보다 부족합니다.
  • 429키별 속도 제한입니다. 본문은 비어 있으며 Retry-After만큼 기다리세요. insufficient_user_quota가 포함된 429는 속도 제한이 아니라 일일 지출 한도입니다.
  • 503 model_not_found알 수 없는 모델이거나, 현재 이 모델을 제공하는 정상 채널이 없습니다.

전체 오류 코드 표 →

#요청 예시

# text → speech (bytes saved to file)
curl https://www.aisplice.store/v1/audio/speech \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "tts-1", "voice": "alloy", "input": "Hello from the gateway."}' \
  --output hello.mp3

# speech → text (multipart)
curl https://www.aisplice.store/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -F file=@meeting.mp3 -F model=whisper-1

#응답

response.json
// /v1/audio/speech → binary audio body (Content-Type: audio/mpeg)

// /v1/audio/transcriptions
{"text": "…transcript…"}

아직 해결되지 않았나요?

요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.

이전3D 모델다음파일 업로드 정책