Google의 Lyria 3 음악 생성 모델입니다. 텍스트 프롬프트로 보컬·가사·다국어를 지원하는 30초 음악 클립을 생성하며, 최대 10장의 참조 이미지로 분위기를 잡을 수 있습니다. MP3 파일을 반환합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "google/lyria-3",
"input": {
"prompt": "Bright upbeat K-pop electro-pop company jingle, 128 BPM, energetic female vocals singing in Korean, catchy chant chorus, synth brass, punchy drums. Lyrics: 코어! 닷! 투데이! 오늘의 상상이 내일의 기술로! 코어! 닷! 투데이! AI도 놀라는 우리의 아이디어!"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 생성할 음악을 설명하는 프롬프트입니다. 장르·악기·분위기·템포·스타일을 구체적으로 적고, 노래라면 가사와 보컬 스타일을 포함하세요. |
images | array | No | [] | 작곡 분위기를 잡아줄 참조 이미지 (최대 10장) |
seed | integer | No | - | 재현성을 높이는 랜덤 시드 (완전한 결정성은 보장되지 않음) |
이 모델의 images 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "google/lyria-3",
"input": {
"prompt": "your prompt here",
"images": ["https://example.com/image.jpg"]
}
}POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 없는 대신, 파일이 API 서버를 거치므로 요청 전체 10MB 제한이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=google/lyria-3" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:images=@your_file.png"POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
모든 음악 모델에 같은 한국어 사가(社歌) 가사를 주고 만든 공통 샘플 — 모델별 결과를 비교해 보세요
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "google/lyria-3",
"input": {
"prompt": "Bright upbeat K-pop electro-pop company jingle, 128 BPM, energetic female vocals singing in Korean, catchy chant chorus, synth brass, punchy drums. Lyrics: 코어! 닷! 투데이! 오늘의 상상이 내일의 기술로! 코어! 닷! 투데이! AI도 놀라는 우리의 아이디어!"
}
}'짧은 스타일 설명으로 만드는 차분한 연주 클립
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "google/lyria-3",
"input": {
"prompt": "A calm acoustic folk song with gentle fingerpicked guitar and soft strings, warm and intimate, 90 BPM. Instrumental only."
}
}'프롬프트에 가사와 보컬 스타일을 넣으면 노래 클립이 됩니다
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "google/lyria-3",
"input": {
"prompt": "Upbeat synth-pop, 120 BPM, bright female vocals singing 'We light up the night' as the chorus hook, punchy drums and shimmering synths."
}
}'