Google

Lyria 3 Pro

lyria-3-pro

Google의 고급 음악 생성 모델로, 약 3분 길이의 48kHz 스테레오 완성곡을 생성하며, 인트로, 벌스, 코러스 등 섹션 구조를 이해하고 프롬프트 준수도가 Lyria 3보다 뛰어납니다

lyria-3-pro

lyria-3-pro 사용해 보기

입력

작품 갤러리

모든 작품 보기

출력

audio

파라미터를 입력하고 생성하면 결과가 여기에 표시됩니다.

가격

lyria-3-pro per song

단가	$0.140

모델 소개

lyria-3-pro는 Google이 출시한 텍스트 기반 음악 생성 모델로, 짧은 조각이 아닌 완성된 곡이 필요한 개발자를 대상으로 합니다. 프롬프트에 곡 스타일, 악기, 감정, 속도, 가사, 곡 구조를 서술하고 타임스탬프를 제공해 구간 구성을 유도할 수 있으며, 최대 10장의 이미지로 창작 방향을 안내할 수도 있습니다. 영상, 게임, 소셜 콘텐츠, 브랜드 프로젝트를 위한 창작 배경음을 대량으로 생성해야 하는 팀에 적합하며, HiAPI.ai 통합 인터페이스로 호출해 기존 제작 파이프라인에 그대로 연결할 수 있습니다.

핵심 하이라이트

구조가 완성된 곡 생성 — 프롬프트에 인트로, 벌스, 코러스, 브릿지 등 구간과 타임스탬프를 지정해 반복되는 조각이 아닌 시작과 끝이 명확한 완전한 곡을 생성합니다.
더 높은 프롬프트 준수도 — Pro 버전답게 곡 스타일, 악기, 편곡 의도를 더 정확하게 재현해 반복 시도의 조정 비용을 줄입니다.
이미지로 창작 방향 안내 지원 — 한 번에 최대 10장의 이미지를 감정과 주제 참고자료로 업로드해 시각 자료의 분위기를 음악 생성에 옮길 수 있습니다.
시드 재현 지원 — seed 파라미터를 전달해 재현 가능한 생성을 시도할 수 있어 반복 작업에서 변수를 통제하기 쉽습니다.

기능 설명

텍스트로 음악 생성: 한 편의 프롬프트로 곡 스타일, 악기, 감정, 속도, 가사, 곡 구조를 서술하면 바로 사용할 수 있는 창작 오디오를 출력합니다.

구조화된 편곡 제어: 프롬프트에 [0:00 - 0:30] 같은 타임스탬프를 사용해 구간의 시작과 끝을 지정함으로써 생성 결과가 정해진 서사 리듬에 맞도록 합니다.

이미지 안내: 1~10장의 이미지를 영감 참고자료로 전달해 작품의 감정, 주제, 전체 편곡 방향을 유도하며, 이미지 자체가 출력의 화면 소재가 되지는 않습니다.

재현 가능한 생성: seed 파라미터로 재현 가능한 생성을 제공하며, 동일한 설정에서 조정 효과를 비교하기 좋지만 완전한 결정성은 보장하지 않습니다.

활용 시나리오

영상 제작 팀: 콘티 대본에 맞춘 배경음 생성 — 화면 리듬과 감정 서술을 프롬프트에 담아 영상 길이에 맞는 창작 음악을 만들고 편집과 후반 작업 과정에 바로 투입합니다.
게임 개발자: 배경음악 커스터마이징 — 레벨 분위기와 반복 재생 요구에 맞춰 곡 스타일과 구간 구조를 서술해 게임에 삽입할 창작 BGM 소재를 생성합니다.
브랜드 및 소셜 크리에이터: 테마 음악 제작 — 브랜드 톤 설명이나 참고 이미지를 입력으로 사용해 콘텐츠에 맞는 전용 음악을 만들어 광고 영상과 소셜 콘텐츠에 활용합니다.
도구 개발자: 음악 생성 기능 통합 — HiAPI.ai 통합 인터페이스를 통해 텍스트 기반 음악 생성을 자체 크리에이티브 도구나 콘텐츠 플랫폼에 연결해 최종 사용자에게 생성 기능을 제공합니다.

한계 및 선택 가이드

1회 생성 길이는 최대 약 3분이며, 이를 초과하는 작품은 구간을 나눠 생성한 뒤 이어 붙여야 하고 최종 결과물에 도달하려면 사람의 후반 편집이 필요합니다. 오디오만 출력하며 화면이나 영상 기능은 포함하지 않습니다. 프롬프트 서술이 구체적일수록 사용 가능한 결과를 얻기 쉬우며, 모호한 설명은 여러 차례 반복이 필요할 수 있습니다. seed는 재현성을 높여주지만 엄격한 결정성을 보장하지는 않습니다. 짧은 조각이나 더 가벼운 시청용 소재만 필요하다면 같은 시리즈의 Lyria 3 등 모델을 고려할 수 있습니다.

생성 작업 제출

POST https://api.hiapi.ai/v1/tasks

헤더

Authorizationstring필수

계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기

Content-Typestring선택

요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.

Idempotency-Keystring선택

멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.

멱등 키

네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.

본문

modelstring필수

현재 고정 값: lyria-3-pro

routestring선택

현재 고정 값: default

inputobject필수

lyria-3-pro 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.

seedinteger선택min 0

선택적 랜덤 시드로, 재현 가능한 생성 결과를 위해 사용됩니다. 동일한 시드가 완전히 동일한 출력을 보장하지는 않습니다.

promptstring필수minLength 1

곡 스타일, 악기, 분위기, 템포, 가사 및 곡 구성을 설명하는 텍스트 프롬프트입니다. [0:00 - 0:30] 형태의 타임스탬프를 추가하여 편곡의 전개 방향을 유도할 수 있습니다.

image_urlsarray선택minItems 1maxItems 10

음악의 분위기, 주제 및 편곡을 유도하는 데 사용되는 선택적 영감 이미지 배열입니다. 이 이미지들은 오디오 출력의 시각적 프레임이나 소스 소재가 아닙니다.

Array [ string ]

callbackobject선택

종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.

콜백(Webhook)

생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.

urlstring필수

callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.

whenstring선택기본값: "final"

현재는 final만 지원(success / fail 모두 알림).

옵션:final

storagestring선택기본값: "temp"

산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.

옵션:temppersistent

요청 예시

# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "lyria-3-pro",
  "input": {
    "prompt": "…"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "lyria-3-pro",
    input: {
      "prompt": "…"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "lyria-3-pro",
        "input": {
          "prompt": "…"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

작업 상세 조회

GET https://api.hiapi.ai/v1/tasks/:id

응답 필드

taskIdstring필수

태스크 ID. 접두사는 항상 tk-hiapi-.

modelstring필수

확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.

routestring선택

route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.

statusstring필수

태스크 상태.

상태 값

queued 대기 중, 아직 시작되지 않음. handling 처리 중. archiving 처리 완료, 산출물 준비 중. success 종료: 완료. 산출물 사용 가능(output 반환). fail 종료: 실패(error 반환). 제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.

creatednumber필수

태스크 생성 시각(Unix 초).

completednumber필수

종료 상태가 된 Unix 초. 비종료 상태에서는 0.

outputarray선택

status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).

Array [ object ]

배열 항목

urlstring필수

산출물 URL. 바로 다운로드할 수 있습니다.

typestring필수

현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.

expireAtnumber필수

산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.

errorobject선택

status == fail일 때만 나타납니다.

codestring필수

비즈니스 오류 코드.

messagestring필수

오류 설명.

응답 예시

성공

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

처리 중(비종료)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

실패

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}