소개
prompt에 희망 길이와 편곡을 포함해 음악을 설명합니다. Lyria 3.5는 44.1kHz 스테레오 MP3 1개를 반환하며 길이와 관계없이 트랙당 과금합니다. 제시된 어쿠스틱 포크 테스트에서는 30초를 요청하고 61.6초 오디오를 받았습니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 오디오 |
| 음악 모델 | Google DeepMind Lyria 3.5 |
| 허용 입력 | prompt |
| 반환 자산 | 44.1kHz 스테레오 MP3 트랙 1개 |
| 인코딩 실측 | 약 193kbps |
| 길이 처리 방식 | 프롬프트의 대략적인 지시이며 길이 필드 없음 |
| 청구 단위 | 길이에 상관없이 생성 트랙 1개 |
핵심 기능 및 하이라이트
음악적 결정을 하나의 지시문에 담기
장르, 분위기, 악기, 템포, 구성, 희망 길이를 모두 프롬프트 텍스트로 적습니다. 팟캐스트 음악에는 절제된 편곡과 도입 동기를, 영상 몽타주에는 에너지가 높아졌다 가라앉는 흐름을 설명합니다. 이렇게 하면 반환 트랙에서 확인할 청취 기준이 구체적으로 정해집니다.
음악을 들은 뒤 편집 구간 계획하기
어쿠스틱 포크 테스트에서 100BPM의 30초 연주곡을 요청하자 약 30초 만에 61.6초 MP3가 반환됐습니다. 이 관찰을 참고해 감상과 자르기 단계를 계획합니다. 정확한 길이 제어나 장르 전반의 일반적인 처리 시간을 입증하는 결과는 아닙니다.
프로젝트에 스테레오 MP3 가져오기
생성마다 44.1kHz 스테레오 MP3 트랙 1개를 제공합니다. 제시된 테스트의 측정값은 약 193kbps였습니다. 도입, 중간, 마무리가 제작 지시와 맞는지 확인합니다. 팟캐스트나 광고에 내레이션이 있다면 최종 믹스를 승인하기 전에 그 음성과 함께 음악을 들어봅니다.
버전별 트랙 수에 맞춰 예산 정하기
생성된 트랙을 단위로 과금하며 트랙 길이에 비례해 요금이 늘어나지 않습니다. 표시된 단가를 확인하고 생성할 가치가 있는 프롬프트 변형을 정합니다. 짧게 요청하면 음악 지시가 달라지지만 과금 단위는 바뀌지 않습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 장르, 분위기, 악기, 템포, 도입부터 마무리까지의 전개를 설명합니다. 연주곡을 원하면 ‘instrumental’을 넣고 요청 길이는 대략적인 지시로 봅니다. 1자 이상 · 5000자 이하 |
image_url | 아니요 | 이 엔드포인트는 지원하지 않으므로 요청에서 image_url을 생략합니다. 원하는 시각적 분위기는 prompt의 음악 설명으로 표현합니다. 1자 이상 |
요금
$0.12 / 곡
생성된 곡마다 길이와 관계없이 한 번 과금합니다. 생성 실패에는 요금을 부과하지 않으며 이 페이지에 표시된 트랙 단가를 확인합니다.
활용 사례
영상에 넣을 배경음악
하이킹 몽타주용으로 핑거피킹 기타, 가벼운 타악기, 부드러운 마무리를 갖춘 100BPM의 경쾌한 어쿠스틱 포크 연주곡을 요청합니다. MP3 1개를 받아 영상과 함께 들어보고 편집 길이에 맞춰 자릅니다.
팟캐스트 오프닝 음악
주간 과학 팟캐스트용으로 둥근 신시사이저 음색, 절제된 드럼, 짧은 도입 동기를 갖춘 90BPM의 호기심 어린 전자 연주곡을 설명합니다. 결과 트랙에서 인사말 아래에 깔 인트로 구간을 골라 편집합니다.
게임 반복 구간용 음악
퍼즐 레벨용으로 부드러운 마림바, 지속음 패드, 반복 구간을 갖춘 80BPM의 차분한 앰비언트 음악을 요청합니다. MP3를 내려받아 쓸 구간을 고른 뒤 오디오 편집기에서 반복 경계를 확인하거나 크로스페이드합니다.
광고 내레이션 배경음악
생활용품 시연용으로 뮤트 기타, 가벼운 베이스, 성긴 타악기를 갖춘 110BPM의 밝은 팝 연주곡을 요청합니다. 반환된 MP3를 배경음악 후보로 삼고 내레이션이 잘 들릴 여유가 있는지 살펴봅니다.
본 제작 전 분위기 스케치
고요한 밤 장면용으로 성긴 피아노로 시작해 끝부분에 따뜻한 현악기를 더하는 70BPM의 사색적인 연주곡을 설명합니다. 최종 음악을 편곡하기 전에 이 트랙으로 음악적 방향을 검토합니다.
프롬프트 가이드 및 실전 팁
음악 제작 지시 정하기
장르, 분위기, 악기 이름, 템포, 도입부터 마무리까지의 구성을 프롬프트에 씁니다. 원하는 길이는 참고 지시로 넣고 연주곡이 필요하면 ‘instrumental’을 명시합니다.
음악 생성 요청 보내기
Bearer 인증을 사용해 https://api.spicyapi.ai/api/v1/jobs/createTask 로 POST 요청을 보냅니다. JSON 본문은 {"model":"google/lyria-3.5/text-to-audio","input":{"prompt":"Calm acoustic folk instrumental, 100 BPM, picked guitar, soft percussion, gentle ending; aim for 30 seconds."}}으로 구성합니다.
완성된 트랙 받기
data.taskId를 저장한 뒤 작업을 생성한 API 키로 GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID를 조회합니다. data.state가 succeeded이면 data.output.assets[0].url에서 MP3를 받습니다.
편집본에서 타이밍 확인하기
타임라인에 배치하기 전에 편곡 전체를 듣고 반환된 길이를 측정합니다. 다른 음악적 방향을 원하면 프롬프트를 조정하고, 끝점을 정확히 맞춰야 하면 파일을 잘라냅니다.
텍스트로 음악을 만드는 Lyria 3.5 API
Google DeepMind의 Lyria 3.5는 글로 쓴 지시문에서 음악 트랙을 생성하고 이 text-to-audio 엔드포인트로 MP3 1개를 제공합니다. prompt에 장르, 분위기, 악기, 템포, 구성, 희망 길이를 설명해 작곡 방향을 정합니다.
Google은 Lyria 3.5 출시 안내에서 음악성, 가사 처리, 보컬 표현을 개선했다고 설명합니다. 아래 어쿠스틱 포크 테스트는 길이와 처리 시간을 측정한 것입니다.
음악 생성 요청 제출하기
input.prompt에 음악 지시문을 담아 google/lyria-3.5/text-to-audio를 제출합니다. 다음 설명용 본문은 실측 테스트 프롬프트와 별개입니다:
{
"model": "google/lyria-3.5/text-to-audio",
"input": {
"prompt": "Gentle acoustic folk instrumental, 100 BPM, picked guitar, warm bass and brushed percussion. Begin with guitar, add a restrained rhythm section, then close softly. Aim for 30 seconds."
}
}
Authorization: Bearer YOUR_API_KEY와Content-Type: application/json을 지정해 본문을POST https://api.spicyapi.ai/api/v1/jobs/createTask로 보냅니다.- 접수 응답에서
data.taskId를 보관합니다. - 작업이 최종 상태에 이를 때까지 생성에 사용한 API 키로
GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID를 조회합니다. succeeded상태가 되면data.output.assets[0].url을 내려받습니다.
작업 결과 읽기
음악이 준비되기 전에 접수된 작업의 ID가 반환됩니다. 다음 축약 응답은 예시 식별자와 자산 주소를 사용합니다:
{
"code": 200,
"data": {
"taskId": "job_YOUR_TASK_ID",
"state": "queued"
}
}
{
"code": 200,
"data": {
"taskId": "job_YOUR_TASK_ID",
"state": "succeeded",
"output": {
"assets": [
{"url": "https://example.com/your-track.mp3"}
]
}
}
}
전체 응답 구조는 작업 API 문서를 참고합니다. 반환된 기록을 사용 가능한 트랙으로 판단하기 전에 최종 상태를 살펴봅니다.
파라미터와 음악 지시
이 엔드포인트에서 제공하는 음악 설정은 prompt로 전달합니다. 템포와 길이는 별도의 숫자 필드 대신 텍스트에 넣습니다.
| 필드 또는 지시 | 사용 방법 |
|---|---|
prompt | 음악 제작 지시를 텍스트로 제공합니다. |
| 장르와 분위기 | 사색적인 어쿠스틱 포크처럼 스타일과 의도한 감정을 적습니다. |
| 악기 | 주선율 악기와 반주 파트를 지정합니다. |
| 템포 | 설명에 BPM이나 진행 속도를 넣습니다. |
| 구성 | 도입, 전개, 마무리를 설명합니다. |
| 희망 길이 | 원하는 길이를 적고 반환된 길이를 검증합니다. |
| 미지원 필드 | image_url, duration, seed, 출력 형식 설정을 생략합니다. |
프로젝트에 맞는 트랙 만들기
구체적인 편곡 지시는 음악을 검토할 기준을 세워줍니다. 광고 배경음악에는 절제된 악기 구성을 요청해 실제 내레이션과 함께 들어봅니다. 게임 음악에는 반복 구간을 요청하고 나중에 반복 경계를 편집합니다.
- 노래 파트 없는 음악을 원하면 ‘instrumental’을 명시합니다.
- 주선율 악기와 소규모 반주 구성을 정해 의도한 믹스를 분명하게 합니다.
- 서로 무관한 분위기 표현을 나열하기보다 에너지의 변화를 설명합니다.
- 다음 버전에서는 지시의 한 부분을 바꾸고 그에 해당하는 음악적 차이를 비교합니다.
- 승인한 MP3와 프롬프트를 함께 보관해 선택한 결과를 계속 사용할 수 있게 합니다.
어쿠스틱 포크 테스트 관찰값
어쿠스틱 포크 연주곡 테스트에서는 100BPM의 30초를 요청하고 61.6초 음악을 받았습니다. 생성에는 약 30초가 걸렸으며 출력은 44.1kHz 스테레오, 약 193kbps의 MP3 1개였습니다.
| 테스트 조건 또는 측정 항목 | 기록값 |
|---|---|
| 제작 지시 | 중립적인 어쿠스틱 포크 연주곡 |
| 요청 템포 | 100BPM |
| 요청 길이 | 30초 |
| 실제 길이 | 61.6초 |
| 처리 시간 | 약 30초 |
| 오디오 | MP3, 44.1kHz 스테레오, 약 193kbps |
이 단일 결과는 길이가 대략적으로 반영됨을 보여주며 음악 스타일 전반의 일반적인 지연 시간이나 품질을 입증하지는 않습니다. 전체 파일을 들어 편곡 변화를 살핀 뒤 길이를 측정하고 잘라 정확한 영상 컷이나 팟캐스트 오프닝에 맞춥니다.
생성 트랙 단위 요금
길이와 무관하게 트랙당 과금합니다. 프롬프트 변형에 대한 예산을 잡을 때 이 페이지의 표시 단가를 확인합니다. 짧은 음악을 요청해도 과금 단위는 달라지지 않습니다. 생성이 실패하면 트랙 요금이 발생하지 않습니다.
제한 사항과 오류 확인
이 엔드포인트에는 전용 길이 설정이 없으므로 요청 길이를 넘으면 편집으로 조정합니다. 요청 실패 시 input에 지원되는 prompt 필드가 있는지 확인하고 반환 오류를 검토한 뒤 지시문을 수정해 제출합니다.
Google은 음악 필터가 특정 아티스트 목소리나 저작권이 있는 가사 요청을 차단한다고 설명합니다. 음악적 특성을 묘사하고 권한이 있는 텍스트와 목소리를 사용하며 실제 인물을 사칭하지 않아야 합니다. Google의 모델 카드에는 SynthID 워터마크도 설명돼 있습니다.
다른 작업 흐름을 위한 관련 모델
편곡과 대략적인 길이를 텍스트로 설명하고 트랙을 내려받으려면 이 엔드포인트를 선택합니다. 짧은 음악용 Clip이나 스트리밍용 RealTime은 연결된 Google 문서를 참고해 검토합니다.
| 필요한 작업 | 검토할 선택지 |
|---|---|
| 편집 타임라인용 프롬프트 기반 MP3 | Lyria 3.5 text-to-audio |
| 길이가 30초로 고정된 음악 클립 | Google에 따르면 Lyria 3 Clip은 30초 클립을 생성합니다. |
| 재생 중 방향을 조절하는 연주곡 | Google은 Lyria RealTime을 상호작용형 스트리밍 모델로 설명합니다. |
| 정확한 컷이나 완성된 반복 구간 | 오디오 편집기에서 내려받은 트랙을 자르거나 크로스페이드합니다. |
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/lyria-3.5/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
