ID で音楽タスクを照会

path task_id で音楽生成タスクを照会します。

音楽生成タスクの照会インターフェースです。作成インターフェースが返す data がタスク ID であり、GET /suno/fetch/{task_id} を通じて単一タスクを照会します。

取得方法

GET /suno/fetch/task_xxx

取得結果

外側は new-api のタスク構造を維持します：

• code：成功時は success です。
• message：エラーまたは案内メッセージ。
• data.task_id：タスク ID。
• data.status：タスクの状態。代表的な値は NOT_START、SUBMITTED、QUEUED、IN_PROGRESS、SUCCESS、FAILURE です。
• data.progress：タスクの進捗。
• data.result_url：成功後に利用可能な結果URL。上流が複数曲を返す場合は、data.data 内のスニペットを基準とします。
• data.data：上流の音楽結果の生データ。通常は曲のスニペットの配列またはオブジェクトを含みます。

成功時の例：

{
 "code": "success",
 "message": "",
 "data": {
 "task_id": "task_xxx",
 "platform": "suno",
 "action": "MUSIC",
 "status": "SUCCESS",
 "progress": "100%",
 "result_url": "https://example.com/audio.mp3",
 "properties": {
 "upstream_model_name": "suno_music",
 "origin_model_name": "suno-v5"
 },
 "data": [
 {
 "id": "clip_xxx",
 "title": "夏日海风",
 "audio_url": "https://example.com/audio.mp3",
 "image_url": "https://example.com/cover.jpg",
 "model_name": "suno-v5",
 "metadata": {
 "duration": 180,
 "prompt": "轻快电子流行，夏日海边，女声 旋律"
 }
 }
 ]
 }
}