curl --request GET \
--url https://api.apimart.ai/v1/music/tasks/task_01K8AYYM6R03TGZ3Q2P0TZVNPX?language=en \
--header 'Authorization: Bearer <token>'
import requests
task_id = "task_01K8AYYM6R03TGZ3Q2P0TZVNPX"
url = f"https://api.apimart.ai/v1/music/tasks/{task_id}"
headers = {
"Authorization": "Bearer <token>"
}
params = {
"language": "en"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
const taskId = "task_01K8AYYM6R03TGZ3Q2P0TZVNPX";
const url = `https://api.apimart.ai/v1/music/tasks/${taskId}?language=en`;
const headers = {
"Authorization": "Bearer <token>"
};
fetch(url, {
method: "GET",
headers: headers
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
{
"code": 200,
"data": {
"id": "task_01K8AYYM6R03TGZ3Q2P0TZVNPX",
"status": "completed",
"progress": 100,
"created": 1783413241,
"completed": 1783413352,
"actual_time": 111,
"cost": 0.06,
"credits_cost": 0.6,
"result": {
"music": [
{
"clip_id": "a41aade4-993e-4d28-b56f-d97e7ef7167c",
"title": "My Song",
"duration_seconds": "181.70666667",
"audio_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.m4a",
"wav_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.wav"
}
]
}
}
}
{
"error": {
"message": "task not found",
"type": "invalid_request",
"param": "task_id",
"code": "task_not_found"
}
}
{
"error": {
"message": "Die aktuelle Gruppenkapazität ist ausgelastet, bitte später erneut versuchen",
"type": "rate_limit_error",
"param": "",
"code": "rate_limit_error"
}
}
Flow Music
Aufgabe abfragen
Abfrage von Ausführungsstatus, Fortschritt und Generierungsergebnissen asynchroner Flow Music-Aufgaben
GET
/
v1
/
music
/
tasks
/
{task_id}
curl --request GET \
--url https://api.apimart.ai/v1/music/tasks/task_01K8AYYM6R03TGZ3Q2P0TZVNPX?language=en \
--header 'Authorization: Bearer <token>'
import requests
task_id = "task_01K8AYYM6R03TGZ3Q2P0TZVNPX"
url = f"https://api.apimart.ai/v1/music/tasks/{task_id}"
headers = {
"Authorization": "Bearer <token>"
}
params = {
"language": "en"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
const taskId = "task_01K8AYYM6R03TGZ3Q2P0TZVNPX";
const url = `https://api.apimart.ai/v1/music/tasks/${taskId}?language=en`;
const headers = {
"Authorization": "Bearer <token>"
};
fetch(url, {
method: "GET",
headers: headers
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
{
"code": 200,
"data": {
"id": "task_01K8AYYM6R03TGZ3Q2P0TZVNPX",
"status": "completed",
"progress": 100,
"created": 1783413241,
"completed": 1783413352,
"actual_time": 111,
"cost": 0.06,
"credits_cost": 0.6,
"result": {
"music": [
{
"clip_id": "a41aade4-993e-4d28-b56f-d97e7ef7167c",
"title": "My Song",
"duration_seconds": "181.70666667",
"audio_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.m4a",
"wav_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.wav"
}
]
}
}
}
{
"error": {
"message": "task not found",
"type": "invalid_request",
"param": "task_id",
"code": "task_not_found"
}
}
{
"error": {
"message": "Die aktuelle Gruppenkapazität ist ausgelastet, bitte später erneut versuchen",
"type": "rate_limit_error",
"param": "",
"code": "rate_limit_error"
}
}
curl --request GET \
--url https://api.apimart.ai/v1/music/tasks/task_01K8AYYM6R03TGZ3Q2P0TZVNPX?language=en \
--header 'Authorization: Bearer <token>'
import requests
task_id = "task_01K8AYYM6R03TGZ3Q2P0TZVNPX"
url = f"https://api.apimart.ai/v1/music/tasks/{task_id}"
headers = {
"Authorization": "Bearer <token>"
}
params = {
"language": "en"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
const taskId = "task_01K8AYYM6R03TGZ3Q2P0TZVNPX";
const url = `https://api.apimart.ai/v1/music/tasks/${taskId}?language=en`;
const headers = {
"Authorization": "Bearer <token>"
};
fetch(url, {
method: "GET",
headers: headers
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
{
"code": 200,
"data": {
"id": "task_01K8AYYM6R03TGZ3Q2P0TZVNPX",
"status": "completed",
"progress": 100,
"created": 1783413241,
"completed": 1783413352,
"actual_time": 111,
"cost": 0.06,
"credits_cost": 0.6,
"result": {
"music": [
{
"clip_id": "a41aade4-993e-4d28-b56f-d97e7ef7167c",
"title": "My Song",
"duration_seconds": "181.70666667",
"audio_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.m4a",
"wav_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.wav"
}
]
}
}
}
{
"error": {
"message": "task not found",
"type": "invalid_request",
"param": "task_id",
"code": "task_not_found"
}
}
{
"error": {
"message": "Die aktuelle Gruppenkapazität ist ausgelastet, bitte später erneut versuchen",
"type": "rate_limit_error",
"param": "",
"code": "rate_limit_error"
}
}
Authentifizierung
string
erforderlich
Alle Flow Music-Endpunkte erfordern eine Bearer-Token-AuthentifizierungAPI-Key erhalten:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API-Key zu erhaltenZum Request-Header hinzufügen:
Authorization: Bearer YOUR_API_KEY
Pfadparameter
string
erforderlich
Die nach dem Absenden einer Flow Music-Aufgabe zurückgegebene Aufgaben-ID
Die Aufgaben-ID stammt aus
data[0].task_id in der Antwort auf die Übermittlung.Abfrageparameter
string
Standard:"zh"
Sprache der Fehlermeldungen und einiger HinweistexteZulässige Werte:
zh, en, ja, koAntwortfelder
integer
Antwortstatuscode, 200 bei Erfolg
object
Aufgabendetails
Anzeigen Aufgabenfelder
Anzeigen Aufgabenfelder
string
Aufgaben-ID
string
Aufgabenstatus:
pending, processing, completed, failedinteger
Aufgabenfortschritt, Bereich 0-100
number
Tatsächlich berechneter Betrag; bei fehlgeschlagenen Aufgaben in der Regel 0
number
Tatsächlich verbrauchte Credits
object
Generierungsergebnisse nach Abschluss der Aufgabe; die zurückgegebenen Felder unterscheiden sich je nach Flow Music-Funktion
Ergebnisstruktur
Musikaufgaben
Musikgenerierung, Verlängerung, Abschnittsersetzung, Cover-Bearbeitung, Stems-Trennung, Audio-Upload, Audio-Download und Videorendering geben in der Regel einresult.music-Array zurück.
{
"result": {
"music": [
{
"clip_id": "a41aade4-993e-4d28-b56f-d97e7ef7167c",
"audio_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.m4a",
"wav_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.wav",
"video_url": "https://cdn.apimart.ai/video/flowmusic_a41aade4.mp4",
"file_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4_stems.zip"
}
]
}
}
Songtext-Aufgaben
Die Songtext-Generierung gibt einresult.lyrics-Array zurück.
{
"result": {
"lyrics": [
{
"title": "Bleached",
"lyrics": "[Intro]\n(Check)\n(One two)\n..."
}
]
}
}
Nutzungshinweise
Alle Flow Music-Übermittlungsendpunkte sind asynchrone Aufgaben. Holen Sie nach erfolgreicher Übermittlung zuerst die
task_id und rufen Sie dann diesen Endpunkt auf, um den Aufgabenstatus abzufragen; sobald status completed ist, lesen Sie die Generierungsergebnisse aus result.