音楽
音楽生成ステータスの取得
音楽生成タスクのステータスと結果を取得します
GET /v1/music/generations/{id} は互換性維持のためのエンドポイントです。既存のインテグレーションでは引き続きサポートされますが、新規のインテグレーションでは GET /v1/tasks/{id} をポーリングしてください。詳細は タスクステータスの取得 を参照してください。
GET /v1/tasks/{id} を呼び出して、音楽生成タスクのステータスを確認します。
id と task_id は同一のタスクを識別します。
期限切れまたは利用不可能なパブリックタスクは 404 async_task_not_found を返す場合があります。現在のAPIキーでタスクの所有権を確認できない場合、レスポンスは 403 task_not_owned となります。
パスパラメータ
音楽生成タスクのID。
レスポンス
タスクID。
返却時に含まれる、同一の非同期タスクIDのエイリアス。
このタスクのステータスURL。id を指定して GET /v1/tasks/{id} をポーリングしてください。
タスクのステータス: pending(保留中)、processing(処理中)、completed(完了)、failed(失敗)、または timeout(タイムアウト)。失敗したタスクでもHTTP 200 が返されます。
オプションの進捗値。実際の進捗値が利用可能な場合にのみ返されます。完了の判定には status を使用してください。
結果フィールドは操作によって異なります。音楽生成では audio_url と audio_id が返される場合があり、歌詞のみのタスクでは lyrics が返されます。分離(セパレーション)タスクでは data 内に複数のファイルが含まれることがあります。video_url、タイトル、進捗、その他のメタデータはオプションです。完了を確認するには status をチェックし、実際に返されたフィールドを読み取ってください。
オプションのソースオーディオID。サポートされている後続の操作で、このタスクのIDと共に使用できます。
オプションの出力配列。audio_url または url を含む分離されたオーディオファイルが含まれます。
オーディオファイルをダウンロードするためのURL(完了時)。30日間有効な TokenLab メディア結果リンクです。
ビジュアライザー付きビデオバージョンのURL(完了時かつモデルが対応している場合)。
モデルがカバー画像を返す場合の画像URL。
生成された曲のタイトル。
生成された、または提供された歌詞。
エラーメッセージ(失敗時)。
タスク失敗時の詳細情報: status、message、type、code、retryable、およびリクエストフィールドに問題がある場合の param。
結果リンクの保存ステータス: days および url、kind、status、expires_at を含む items[]。このフィールドは存在しない場合もありますが、リンクは引き続き機能します。データ保持 を参照してください。
リクエスト
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"レスポンス
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"audio_url": "https://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night...",
"audio_id": "audio_abc123",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"kind": "audio",
"content_type": "audio/mpeg",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
パスパラメータ
id / task_id によって返される、または poll_url に埋め込まれた非同期タスクID
レスポンス
application/json
application/json
application/json
application/json
application/json
application/json
application/json