인증 및 보안
Base URL, API 키 사용 방법, 요청 제한.
Base URL
모든 API 요청은 다음 주소로 보냅니다:
https://api.marswave.ai/openapi샌드박스/테스트 환경 이용은 support@marswave.ai로 문의하세요.
API 키
API 키 발급받기
- API 키 설정 페이지로 이동합니다
- API 키 만들기를 클릭합니다
- 키를 복사해 저장합니다
사용 방법
모든 요청의 Authorization 헤더에 API 키를 포함합니다:
curl -X GET "https://api.marswave.ai/openapi/v1/speakers/list" \
-H "Authorization: Bearer $LISTENHUB_API_KEY"const response = await fetch('https://api.marswave.ai/openapi/v1/speakers/list', {
headers: {
'Authorization': `Bearer ${process.env.LISTENHUB_API_KEY}`,
},
});import os
import requests
response = requests.get(
'https://api.marswave.ai/openapi/v1/speakers/list',
headers={'Authorization': f'Bearer {os.environ["LISTENHUB_API_KEY"]}'}
)환경 변수 설정
API 키를 LISTENHUB_API_KEY로 저장하세요. 이 문서의 모든 코드 예제는 이 변수명을 사용합니다:
# Add to ~/.zshrc or ~/.bashrc
export LISTENHUB_API_KEY="your_api_key_here"또는 프로젝트 루트에 .env 파일을 만듭니다(불러오려면 dotenv 같은 라이브러리가 필요합니다):
# .env
LISTENHUB_API_KEY=your_api_key_here보안 모범 사례
API 키는 계정 자격 증명과 같습니다. 키가 유출되면 크레딧이 무단으로 소비될 수 있습니다.
- 항상 HTTPS를 사용하세요
- API 키를 클라이언트 사이드 코드에 두지 마세요
- API 키나
.env파일을 Git 저장소에 커밋하지 마세요 - API 키는 환경 변수에 저장하세요
레이트 리밋
| 제한 항목 | 값 | 설명 |
|---|---|---|
| 생성 요청 레이트 | 3 RPM | 1분당 최대 3회의 생성 요청 |
| 제한 초과 에러 코드 | 29998 | 백오프 재시도 전략을 구현하세요 |
읽기 전용 요청(에피소드 상태 조회, 스피커 목록 조회 등)은 이 제한의 대상이 아닙니다.