MPS APILast Updated 2026-09-30

Google Lyria

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcAudioTask

기본 정보

항목	값
ModelName	`GL`
ModelVersion	`3.0-clip` / `3.0-pro`
SceneType	`music`

클립과 풀 트랙 두 버전이 있습니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `GL`
`ModelVersion`	선택	String	`3.0-clip` 또는 `3.0-pro`
`SceneType`	필수	String	`music`
`Prompt`	필수	String	장르, 악기 구성, 분위기, 템포를 구체적으로 기술
`Duration`	선택	Integer	길이(초). `0~60`
`OutputAudioFormat`	선택	String	`mp3`

ModelName=GL을 사용합니다. 콘솔에는 Google Lyria로 표시됩니다.

요청 예시

LANGUAGE
{
  "ModelName": "GL",
  "ModelVersion": "3.0-pro",
  "SceneType": "music",
  "Prompt": "an epic orchestral soundtrack with rising tension, strings and brass. Lyrics: Hold on to the light, we will make it through the night",
  "Duration": 30,
  "Operator": "admin"
}

응답 예시

LANGUAGE
{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "AudioInfos": [
      {
        "Url": "https://aigc-output-audio-file-<id>.cos.<region>.myqcloud.com/<file>.mp3?q-sign-algorithm=sha1&..."
      }
    ],
    "VideoInfos": [],
    "RequestId": "<request-id>"
  }
}

특수 설정

버전 비교

항목	`3.0-clip`	`3.0-pro`
길이	약 `30초`	약 `2분` `30초` 이상
처리 시간	짧음	김
파일 크기	작음	큼
용도	인트로, 짧은 삽입 음악	완성 트랙

프롬프트 작성 규칙

GL은 가사와 스타일을 하나의 프롬프트에 담습니다.

가사와 스타일을 모두 지정

LANGUAGE

{스타일 설명}

Lyrics:
{가사 내용}

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

스타일만 지정

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

반주만 만들기

스타일 설명 뒤에 instrumental, no vocals.를 붙입니다.

형식을 지켜야 가사가 반영됩니다

Lyrics: 표기와 앞뒤 빈 줄이 있어야 모델이 가사를 인식합니다. 형식이 어긋나면 가사가 스타일 설명으로 처리됩니다.