Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
다양한 사용 사례와 매개변수 구성을 살펴보세요
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
Suno timestamped-lyrics musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 사용 전체 가이드
오디오 재생 중 동기화된 표시를 위해 타임스탬프가 포함된 가사를 가져옵니다. 음악 플레이어 인터페이스에서 노래방 스타일의 가사 표시를 구현하는 데 적합합니다.
Suno 타임스탬프 가사 API는 생성된 음악 트랙에 대한 동기화된 가사 데이터를 제공합니다. 각 가사 줄에는 초 단위의 정확한 타임스탬프 정보가 포함되어 있어 개발자가 노래방 스타일 표시, 가사 동기화 기능, 향상된 음악 재생 경험을 만들 수 있습니다. 또한 이 API는 오디오 시각화를 위한 파형 데이터도 반환하므로, 가사 표시와 시각적 오디오 표현을 모두 갖춘 종합적인 음악 플레이어 인터페이스를 구축하는 데 이상적입니다.
Suno 타임스탬프 가사 API는 초 단위의 정확한 타임스탬프 값이 포함된 가사를 제공하여 텍스트 표시와 오디오 재생이 완벽하게 동기화되도록 합니다. 각 가사 줄은 오디오 트랙에 맞춰 정밀하게 타이밍이 지정됩니다.
이 API는 타임스탬프 가사와 함께 오디오 시각화에 사용할 수 있는 파형 데이터 배열을 반환합니다. 이를 통해 개발자는 시각적 오디오 표현을 갖춘 풍부하고 인터랙티브한 음악 플레이어 인터페이스를 만들 수 있습니다.
API 출력은 노래방 스타일 애플리케이션에 최적화되어 있습니다. 정확한 타이밍과 완전한 가사 텍스트를 통해 개발자는 따라 부르는 동안 가사를 강조 표시하는 기능과 스크롤 가사 표시를 쉽게 구현할 수 있습니다.
계정을 만들고 Suno 타임스탬프 가사 API 키를 받으세요. 이 키는 모든 요청을 인증하고 사용량을 계정에 연결합니다.
먼저 Suno 음악 생성 API를 사용하여 오디오 트랙을 만드세요. 생성 응답에서 taskId와 audioId를 저장하세요. 타임스탬프 가사를 가져오려면 이 값들이 필요합니다.
taskId와 audioId로 타임스탬프 가사 API를 호출하세요. API는 정확한 타임스탬프와 파형 정보가 포함된 동기화된 가사 데이터를 반환합니다.
타임스탬프 데이터를 사용하여 애플리케이션에서 동기화된 가사 표시를 구현하세요. 파형 데이터와 결합하면 향상된 시각 효과를 만들 수 있습니다.
이 API에는 taskId와 audioId 매개변수가 모두 필요합니다. taskId는 생성 세션을 식별하고, audioId는 해당 세션 내의 정확한 트랙을 지정합니다.
모든 타임스탬프 값은 부동소수점 숫자로 초 단위로 제공됩니다. 이를 통해 필요한 경우 밀리초 수준까지 정확한 동기화가 가능합니다.
instrumental=true로 생성된 트랙의 경우 가사 데이터를 사용할 수 없습니다. 그래도 API는 파형 및 길이 정보를 반환합니다.
동기화된 가사를 음악 플레이어 애플리케이션에 통합하여, 사용자가 오디오 재생에 맞춰 강조 표시되는 텍스트와 함께 실시간으로 노래를 따라갈 수 있도록 합니다.
정확한 가사 타이밍으로 노래방 기능을 구축하여, 사용자가 정확한 순간에 가사를 강조 표시하는 시각적 안내와 함께 따라 부를 수 있도록 합니다.
사용자가 노래 가사를 익히고, 곡 구조를 이해하며, 정확하게 동기화된 텍스트 표시로 타이밍을 연습할 수 있도록 돕는 교육용 애플리케이션을 만드세요.
소셜 플랫폼에서 오디오 재생과 함께 동기화된 가사를 표시하여 음악 공유 기능을 강화하고, 더 몰입도 높은 콘텐츠 경험을 만드세요.
apipass.dev는 Suno 타임스탬프 가사 API 액세스에 대해 비용 효율적인 가격을 제공하여, 개인 개발자부터 대규모 애플리케이션까지 모든 규모의 프로젝트에서 쉽게 사용할 수 있도록 합니다.
코드 예제와 통합 가이드가 포함된 명확하고 자세한 API 문서는 개발자가 애플리케이션에 타임스탬프 가사 기능을 빠르게 구현할 수 있도록 돕습니다.
24시간 기술 지원을 통해 가사 동기화 기능이 안정적으로 작동하도록 보장하며, 필요할 때마다 전문가의 도움을 받을 수 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
SDK를 사용해 작업을 만들고 반환된 taskId를 저장한 다음 Suno의 결과를 조회합니다.
이 SDK 예제를 실행하기 전에 @apipass-dev/apipass-sdk을 설치하세요.
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdkAPI Key는 서버 측 환경 변수에 보관하세요. SDK는 이를 Bearer token으로 자동 전송하고 JSON 헤더를 추가합니다.
client.jobs.createTask오디오 재생 중 동기화된 표시를 위해 타임스탬프가 포함된 가사를 가져옵니다
이 예제를 사용해 선택한 SDK를 빠르게 시작하세요.
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const task = await client.jobs.createTask({
8 "model": "suno/timestamped-lyrics",
9 "input": {
10 "taskId": "task_xxx",
11 "audioId": "audio_xxx"
12 }
13});
14
15console.log(task.data.taskId);이 API는 다음 구조의 JSON payload를 받습니다:
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}model필수string타임스탬프가 포함된 가사를 가져오는 데 사용할 모델 이름입니다
"suno/timestamped-lyrics"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 provider를 지정할 수 있습니다. 이러한 provider는 실제 이미지 및 비디오 생성 작업을 처리합니다. APIPASS는 현재 세 가지 provider 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격과 안정성 지표를 기반으로 사용 가능한 provider 간에 작업을 자동으로 할당하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 별도의 라우팅 요구 사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 폼 구성에 따라 다음 파라미터가 포함됩니다:
input.taskId필수string이전 suno/generate 또는 suno/extend createTask 호출에서 반환된 ApiPass taskId입니다. 업스트림 NextMusic provider task ID를 전달하지 마세요.
필수 필드, 최대 길이: 100자
"task_12345678"
input.audioId필수string완료된 원본 작업 결과 항목의 오디오 ID입니다.
필수 필드, 최대 길이: 100자
"audio_abc123xyz"
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxx"
6 }
7}code상태 코드입니다. 200은 성공을 의미하며, 그 외 값은 실패를 의미합니다
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다
data.lyrics가사 객체 배열입니다. 각 객체에는 타임스탬프(초 단위)와 텍스트가 포함됩니다
data.lyrics[].timestamp이 가사 줄이 표시되어야 하는 시점을 나타내는 초 단위 타임스탬프 값입니다
data.lyrics[].text지정된 타임스탬프에 표시할 가사 텍스트입니다
data.waveform오디오 시각화를 위한 waveform 데이터 배열입니다
data.duration오디오 트랙의 전체 길이(초 단위)입니다
client.jobs.recordInfoCover 생성 작업 상태를 조회하고 결과를 가져옵니다
이 예제를 사용해 선택한 SDK를 빠르게 시작하세요.
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const result = await client.jobs.recordInfo("<taskId>");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_cover_abc123",
5 "state": "success",
6 "resultJson": {
7 "data": {
8 "lyrics": [
9 {
10 "text": "Verse 1 starts here",
11 "timestamp": 0
12 },
13 {
14 "text": "With lyrics synchronized",
15 "timestamp": 3.5
16 },
17 {
18 "text": "To the audio playback",
19 "timestamp": 7.2
20 }
21 ],
22 "duration": 180.5,
23 "waveform": [
24 0.1,
25 0.3,
26 0.5,
27 0.8,
28 0.6,
29 0.4,
30 0.2
31 ]
32 }
33 }
34 }
35}data.state현재 상태: queuing, generating, success 또는 fail
data.resultJson.dataURL 및 메타데이터가 포함된 생성된 Cover 버전 배열입니다
API 페이지는 매개변수 스키마를 보여주지만, Suno는 누락하기 쉬운 여러 비즈니스 특화 모드 조합 및 콜백 규칙도 가지고 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
오디오 재생 중 동기화된 표시를 위해 타임스탬프가 포함된 가사를 가져옵니다
이 API는 다음 구조의 JSON payload를 받습니다:
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}model필수string타임스탬프가 포함된 가사를 가져오는 데 사용할 모델 이름입니다
"suno/timestamped-lyrics"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 provider를 지정할 수 있습니다. 이러한 provider는 실제 이미지 및 비디오 생성 작업을 처리합니다. APIPASS는 현재 세 가지 provider 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격과 안정성 지표를 기반으로 사용 가능한 provider 간에 작업을 자동으로 할당하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 별도의 라우팅 요구 사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 폼 구성에 따라 다음 파라미터가 포함됩니다:
input.taskId필수string이전 suno/generate 또는 suno/extend createTask 호출에서 반환된 ApiPass taskId입니다. 업스트림 NextMusic provider task ID를 전달하지 마세요.
필수 필드, 최대 길이: 100자
"task_12345678"
input.audioId필수string완료된 원본 작업 결과 항목의 오디오 ID입니다.
필수 필드, 최대 길이: 100자
"audio_abc123xyz"
1curl -X POST "https://api.apipass.dev/api/v1/generate/get-timestamped-lyrics" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "suno/timestamped-lyrics",
6 "input": {
7 "taskId": "task_xxx",
8 "audioId": "audio_xxx"
9 }
10 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxx"
6 }
7}code상태 코드입니다. 200은 성공을 의미하며, 그 외 값은 실패를 의미합니다
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다
data.lyrics가사 객체 배열입니다. 각 객체에는 타임스탬프(초 단위)와 텍스트가 포함됩니다
data.lyrics[].timestamp이 가사 줄이 표시되어야 하는 시점을 나타내는 초 단위 타임스탬프 값입니다
data.lyrics[].text지정된 타임스탬프에 표시할 가사 텍스트입니다
data.waveform오디오 시각화를 위한 waveform 데이터 배열입니다
data.duration오디오 트랙의 전체 길이(초 단위)입니다
