如果创建响应中包含
poll_url,请优先直接调用该 URL 轮询。/v1/tasks/{id} 是音乐任务的固定状态端点,id 与 task_id 应视为同一个异步任务标识。如果该任务已不存在或无法再从公开任务记录中查询到,AI Sonar 会返回 async_task_not_found,并附带消息 Task not found or no longer available.路径参数
string
必填
音乐生成任务 ID。
响应
string
任务 ID。
string
返回时,作为异步任务标识的别名。
string
创建响应提供时,优先使用的轮询 URL。
string
任务状态:
pending、processing、completed 或 failed。integer
可选进度值。仅在任务提供真实进度时返回;请使用
status 判断任务是否完成。string
音频文件的下载 URL(完成时)。
string
带可视化效果的视频版本 URL(完成时)。
string
生成的歌曲标题。
string
生成或提供的歌词。
string
错误信息(失败时)。
curl "https://api.aisonar.dev/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"
import requests
import time
task_id = "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
while True:
response = requests.get(
f"https://api.aisonar.dev/v1/tasks/{task_id}",
headers={"Authorization": "Bearer sk-your-api-key"}
)
result = response.json()
if result["status"] == "completed":
print(f"Audio URL: {result['audio_url']}")
break
elif result["status"] == "failed":
print(f"Error: {result['error']}")
break
time.sleep(5)
const taskId = 'ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
async function pollForMusic() {
while (true) {
const response = await fetch(
`https://api.aisonar.dev/v1/tasks/${taskId}`,
{ headers: { 'Authorization': 'Bearer sk-your-api-key' } }
);
const result = await response.json();
if (result.status === 'completed') {
console.log(`Audio URL: ${result.audio_url}`);
return result.audio_url;
} else if (result.status === 'failed') {
throw new Error(result.error);
}
await new Promise(r => setTimeout(r, 5000));
}
}
package main
import (
"encoding/json"
"fmt"
"net/http"
"time"
)
func main() {
taskID := "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
for {
req, _ := http.NewRequest("GET",
fmt.Sprintf("https://api.aisonar.dev/v1/tasks/%s", taskID), nil)
req.Header.Set("Authorization", "Bearer sk-your-api-key")
client := &http.Client{}
resp, _ := client.Do(req)
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
resp.Body.Close()
if result["status"] == "completed" {
fmt.Printf("Audio URL: %s\n", result["audio_url"])
break
} else if result["status"] == "failed" {
fmt.Printf("Error: %s\n", result["error"])
break
}
time.Sleep(5 * time.Second)
}
}
<?php
$taskId = 'ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
while (true) {
$ch = curl_init("https://api.aisonar.dev/v1/tasks/{$taskId}");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer sk-your-api-key'
]
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
if ($result['status'] === 'completed') {
echo "Audio URL: {$result['audio_url']}\n";
break;
} elseif ($result['status'] === 'failed') {
echo "Error: {$result['error']}\n";
break;
}
sleep(5);
}
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"audio_url": "https://cdn.example.com/music/abc123.mp3",
"video_url": "https://cdn.example.com/music/abc123.mp4",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night..."
}