eroq api · 음악
한 문장을 넣으면,
노래가 나와요.
eroq의 자체 엔진 Music One이 편곡하고 노래까지 불러요. 곡을 한 문장으로 설명하면 작사 기능이 스타일, 가사, 제목을 써 주고, 섹션 태그를 넣은 가사를 직접 보낼 수도 있어요. 30초에서 4분까지, 호출당 기본 두 테이크, 다른 모든 기능과 같은 키로.
MP3 출력 · 30초~4분 · 실패한 테이크는 자동 환불
가입 시 무료 크레딧 50개 · 카드 등록 불필요
curl https://eroq.ai/v1/music/generations \
-H "Authorization: Bearer $EROQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "eroq-music-one",
"style": "english, female vocals, synth-pop, 104 bpm, warm analog synths, gated drums",
"lyrics": "[Verse]\nStreetlights fade behind the bus\nThe town I knew is shrinking fast\n\n[Chorus]\nI'\''m leaving, leaving, nothing left to prove\nThe road is long and I'\''m in love with the move",
"title": "Leaving Light",
"seconds": 120,
"n": 2
}'제공 기능
Music, 실제 출시하는 제품을 위해 만들었어요.
한 문장, 또는 내 가사
곡을 한 문장으로 쓴 prompt를 보내면 작사 기능이 스타일, 가사, 제목을 써 주고, 이 비용은 가격에 포함돼요. 아니면 직접 쓴 style과 lyrics를 보내고, 섹션 태그는 각각 한 줄에 따로 두세요: [Intro], [Verse], [Pre-Chorus], [Chorus], [Bridge], [Outro]. 가사 없이 스타일만 보내면 그 스타일에 맞춰 가사를 써 주고, 202 응답에는 노래의 바탕이 되는 내용이 그대로 담겨 와요.
보컬을 넣거나, 빼거나
언어, 보컬, 장르, 템포, 악기는 쉼표로 구분한 단어로 스타일에 넣어요. instrumental: true로 하면 보컬이 빠지고 가사는 무시돼요. 반주 트랙, 내레이션 밑에 까는 배경 음악, 방송용 루프에 쓰세요.
두 테이크, 따로따로
n을 한 테이크나 두 테이크로 지정하세요(기본값은 두 테이크). 테이크마다 시드, 작업, 과금이 따로라서 더 나은 쪽을 고르면 돼요. seed를 넘기면 테이크를 재현할 수 있어요: 테이크 N은 seed + N − 1로 렌더링돼요.
제출하고 잊으세요
노래 한 곡에는 GPU로 몇 분이 걸려서, 호출하면 테이크마다 작업 하나씩을 담아 202로 응답해요. MP3가 준비될 때까지 무료인 GET /v1/music/generations/{id}를 폴링하거나, music.generation.succeeded와 music.generation.failed에 웹훅을 등록하세요.
요청한 길이만큼 과금
요청한 길이를 기준으로, 테이크마다 시작된 30초당 3 크레딧이에요. 2분짜리 노래를 두 테이크로 만들면 24 크레딧이고요. 가격은 가사나 스타일에 따라 달라지지 않고, 실패한 테이크는 따로 환불되며 나머지 테이크는 그대로 전달돼요.
에이전트에서도
MCP 서버가 generate_music과 get_music_status를 제공하니, 코딩 에이전트가 대화를 벗어나지 않고 사운드트랙을 만들 수 있어요. CLI에서는 eroq music에 한 문장과 길이만 주면 돼요. 완성된 테이크는 레시피와 함께 라이브러리에도 저장돼서, 스튜디오에서 리믹스할 수 있어요.
자주 묻는 질문
핵심만 짧게.
노래 한 곡은 얼마인가요? +
요청한 길이를 기준으로 테이크마다 시작된 30초당 3 크레딧이에요. 길이는 30초에서 4분까지, 30초 단위예요. 1분이면 테이크당 6 크레딧, 2분짜리 두 테이크면 24 크레딧이에요. 작업 폴링은 무료예요.
직접 쓴 가사를 보낼 수 있나요? +
네: 섹션 태그를 각각 한 줄에 둔 가사([Intro], [Verse], [Pre-Chorus], [Chorus], [Bridge], [Outro])와 스타일을 보내세요. 가사를 빼면 작사 기능이 스타일에 맞춰 가사를 쓰고, prompt만 보내면 스타일, 가사, 제목을 모두 써 줘요.
가수를 고를 수 있나요? +
가수는 스타일에서 묘사해요: 따뜻한 여성 보컬, 거친 바리톤, 합창단처럼요. 노래용 보이스 레퍼런스는 없고, 음성 API의 복제 보이스는 말을 할 뿐 노래하지는 않아요. 사운드는 아티스트 이름이 아니라 장르, 시대, 보컬로 묘사하세요.
어떤 파일을 받나요? +
테이크마다 MP3 하나(320 kbps, 48 kHz 스테레오)를 서명된 CDN URL로, 테이크의 실제 길이와 함께 받아요. 스템도, 보컬만 분리된 트랙도, 스트리밍 오디오도 없어요: 테이크는 완성된 파일 하나로 도착해요.
콘텐츠 정책상 거부되는 건 무엇인가요? +
정책은 보내는 모든 단어와 작사 기능이 쓰는 내용에 적용돼요: 미성년자와 관련된 것, 동의 없이 식별 가능한 실존 인물, 불법적인 것은 안 돼요. 거부된 노래는 400 content_blocked로 응답하고 과금되지 않으며, 작성된 가사가 문제였다면 환불돼요.