REST API를 사용하여 애플리케이션에 강력한 음악 생성 기능을 구축하세요.
단일 API 호출로 첫 번째 트랙을 생성하세요.
curl -X POST https://api.fm9.ai/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "업비트 일렉트로닉 댄스 음악"}'{
"id": "gen_abc123",
"status": "processing",
"estimated_time": 30
}모든 API 요청에는 API 키가 필요합니다. Authorization 헤더에 키를 포함하세요:
API 키는 다음에서 받으세요 개발자 대시보드.
Authorization: Bearer YOUR_API_KEY/v1/generate새 음악 생성 작업을 만듭니다.
prompt-생성할 음악의 텍스트 설명 (필수)duration-트랙 길이(초) (30-180, 기본값: 60)style-음악 스타일 프리셋 (선택)instrumental-인스트루멘탈만 생성할지 여부 (기본값: false)작업 ID와 상태가 포함된 생성 객체를 반환합니다.
/v1/generation/:id생성 작업의 상태를 확인합니다.
현재 상태가 포함된 생성 객체를 반환하고, 완료 시 다운로드 URL이 포함됩니다.
/v1/generations생성 기록 목록을 검색합니다.
limit-반환할 결과 수 (기본값: 20, 최대: 100)offset-페이지네이션 오프셋 (기본값: 0)status-상태별 필터 (pending, processing, completed, failed)사용량 기반의 간단하고 투명한 가격 책정.
월 10회 생성
월 500회 생성
무제한
공정한 사용과 서비스 안정성을 보장하기 위해 다음 속도 제한이 적용됩니다:
속도 제한을 초과하면 429 Too Many Requests 응답을 받게 됩니다.
API는 표준 HTTP 응답 코드를 사용하여 성공 또는 실패를 나타냅니다.
| Code | Description |
|---|---|
| 400 | Bad Request - 잘못된 매개변수 |
| 401 | Unauthorized - 유효하지 않거나 누락된 API 키 |
| 402 | Payment Required - 크레딧 부족 |
| 429 | Too Many Requests - 속도 제한 초과 |
| 500 | Internal Server Error - 서버 측 오류 발생 |