Google Lyria
On this page
Endpoint: POST https://vod.intl.tencentcloudapi.com
Action: CreateAigcAudioTask
기본 정보
| 항목 | 값 |
|---|---|
| ModelName | GL |
| ModelVersion | 3.0-clip / 3.0-pro |
| SceneType | music |
| 출력 비트레이트 | 192 kbps 고정 |
클립과 풀 트랙 두 버전이 있습니다.
요청 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
|---|---|---|---|
ModelName |
필수 | String | 고정값 GL |
ModelVersion |
선택 | String | 3.0-clip 또는 3.0-pro |
SceneType |
필수 | String | music |
Prompt |
필수 | String | 장르, 악기 구성, 분위기, 템포를 구체적으로 기술 |
요청 예시
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "GL",
"ModelVersion": "3.0-clip",
"SceneType": "music",
"Prompt": "a warm acoustic guitar loop, gentle and hopeful, 90 bpm"
}
{
"SubAppId": 123456789,
"ModelName": "GL",
"ModelVersion": "3.0-pro",
"SceneType": "music",
"Prompt": "an epic orchestral soundtrack, strings and brass, rising tension, cinematic finale"
}
응답 예시
LANGUAGE
{
"AigcAudioTask": {
"Status": "FINISH",
"ErrCode": 0,
"Output": {
"AudioInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcAudioGenFile.mp3"
}
]
}
}
}가사와 스타일
가사와 스타일은 하나의 Prompt에 함께 작성합니다. 별도 lyrics 필드를 사용하지 않습니다.
특수 설정
버전 비교
| 항목 | 3.0-clip |
3.0-pro |
|---|---|---|
| 길이 | 약 30초 |
약 2분 36초 |
| 처리 시간 | 짧음 | 김 |
| 파일 크기 | 작음 | 큼 |
| 용도 | 인트로, 짧은 삽입 음악 | 완성 트랙 |
프롬프트 작성 규칙
GL은 가사와 스타일을 하나의 프롬프트에 담습니다. 아래 형식 중 용도에 맞는 방식을 선택하세요.
가사와 스타일을 모두 지정
LANGUAGE
{스타일 설명}
Lyrics:
{가사 내용}스타일 설명과 가사 사이에 빈 줄을 하나 두고, Lyrics: 줄 다음에 가사를 사용합니다.
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "GL",
"ModelVersion": "3.0-pro",
"SceneType": "music",
"Prompt": "a warm acoustic folk ballad, fingerpicked guitar, 84 bpm\n\nLyrics:\nThe morning light falls on the empty street\nI walk alone but the city breathes with me",
"OutputConfig": {
"StorageMode": "Temporary",
"OutputAudioFormat": "mp3"
}
}스타일만 지정
가사 필드를 생략하면 모델이 가사를 자동 생성합니다.
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "GL",
"ModelVersion": "3.0-clip",
"SceneType": "music",
"Prompt": "a warm acoustic guitar loop, gentle and hopeful, 90 bpm",
"OutputConfig": {
"StorageMode": "Temporary",
"OutputAudioFormat": "mp3"
}
}반주만 만들기
스타일 설명 뒤에 instrumental, no vocals.를 붙입니다.
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "GL",
"ModelVersion": "3.0-pro",
"SceneType": "music",
"Prompt": "an epic orchestral soundtrack, strings and brass, rising tension, cinematic finale, instrumental, no vocals.",
"OutputConfig": {
"StorageMode": "Temporary",
"OutputAudioFormat": "mp3"
}
}형식을 지켜야 가사가 반영됩니다
Lyrics: 표기와 앞뒤 빈 줄이 있어야 모델이 가사를 인식합니다. 형식이 어긋나면 가사가 스타일 설명으로 처리됩니다.
출력 포맷
OutputConfig.OutputAudioFormat으로 결과 파일 형식을 지정합니다.
LANGUAGE
{
"OutputConfig": {
"StorageMode": "Temporary",
"OutputAudioFormat": "mp3"
}
}출력 비트레이트는 192 kbps로 고정됩니다
GL의 출력 비트레이트는 192 kbps입니다.
추가 옵션
GL의 가사는 프롬프트에 직접 포함합니다. 3.0-pro는 장르 / 악기 / 템포 / 분위기를 구체적으로 작성하세요.