Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
さまざまなユースケースとパラメータ設定を確認できます
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
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 ペイロードを受け付けます:
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 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています:
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を保持してください。
利用可能なオプション：
auto
input オブジェクトには、フォーム設定に基づく次のパラメータが含まれます:
input.taskId必要string以前の suno/generate または suno/extend createTask 呼び出しによって返された ApiPass taskId。上流の NextMusic プロバイダーのタスク 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音声可視化用の波形データ配列
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.data生成された Cover バージョンの配列。URL とメタデータが含まれます
APIページにはパラメータスキーマが表示されますが、Sunoには見逃しやすいビジネス特有のモードの組み合わせやコールバックルールがいくつかあります。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
音声再生中の同期表示に使用するタイムスタンプ付き歌詞を取得します
この API は、次の構造の JSON ペイロードを受け付けます:
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 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています:
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を保持してください。
利用可能なオプション：
auto
input オブジェクトには、フォーム設定に基づく次のパラメータが含まれます:
input.taskId必要string以前の suno/generate または suno/extend createTask 呼び出しによって返された ApiPass taskId。上流の NextMusic プロバイダーのタスク 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音声可視化用の波形データ配列
data.duration音声トラックの合計再生時間（秒単位）
