Google Lyria

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: 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	장르, 악기 구성, 분위기, 템포를 구체적으로 기술

요청 예시

{
  "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"
}

응답 예시

{
  "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은 가사와 스타일을 하나의 프롬프트에 담습니다. 아래 형식 중 용도에 맞는 방식을 선택하세요.

가사와 스타일을 모두 지정

{스타일 설명}

Lyrics:
{가사 내용}

스타일 설명과 가사 사이에 빈 줄을 하나 두고, Lyrics: 줄 다음에 가사를 사용합니다.

{
  "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"
  }
}

스타일만 지정

가사 필드를 생략하면 모델이 가사를 자동 생성합니다.

{
  "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.를 붙입니다.

{
  "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으로 결과 파일 형식을 지정합니다.

{
  "OutputConfig": {
    "StorageMode": "Temporary",
    "OutputAudioFormat": "mp3"
  }
}

출력 비트레이트는 192 kbps로 고정됩니다

GL의 출력 비트레이트는 192 kbps입니다.

추가 옵션

GL의 가사는 프롬프트에 직접 포함합니다. 3.0-pro는 장르 / 악기 / 템포 / 분위기를 구체적으로 작성하세요.