curl --request POST \
--url https://api.apimart.ai/v1/music/generations/uploadCover \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"version": "v6",
"audio_url": "https://example.com/reference.mp3",
"custom": true,
"instrumental": true,
"tags": "piano, ambient",
"duration_s": 120,
"variety": "normal",
"audio_format": "m4a"
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/music/generations/uploadCover",
headers={"Authorization": "Bearer <token>"},
json={
"model": "suno",
"version": "v6",
"audio_url": "https://example.com/reference.mp3",
"custom": True,
"instrumental": True,
"tags": "piano, ambient",
"duration_s": 120,
"audio_format": "m4a",
},
)
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/music/generations/uploadCover", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "suno",
version: "v6",
audio_url: "https://example.com/reference.mp3",
custom: true,
instrumental: true,
tags: "piano, ambient",
duration_s: 120,
audio_format: "m4a"
})
});
console.log(await response.json());
{
"code": 200,
"data": [
{"status": "submitted", "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"}
]
}
Suno
Audio hochladen und Cover erstellen
Eine öffentliche Audio-URL hochladen und mit Suno V6 ein Cover erstellen
POST
/
v1
/
music
/
generations
/
uploadCover
curl --request POST \
--url https://api.apimart.ai/v1/music/generations/uploadCover \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"version": "v6",
"audio_url": "https://example.com/reference.mp3",
"custom": true,
"instrumental": true,
"tags": "piano, ambient",
"duration_s": 120,
"variety": "normal",
"audio_format": "m4a"
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/music/generations/uploadCover",
headers={"Authorization": "Bearer <token>"},
json={
"model": "suno",
"version": "v6",
"audio_url": "https://example.com/reference.mp3",
"custom": True,
"instrumental": True,
"tags": "piano, ambient",
"duration_s": 120,
"audio_format": "m4a",
},
)
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/music/generations/uploadCover", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "suno",
version: "v6",
audio_url: "https://example.com/reference.mp3",
custom: true,
instrumental: true,
tags: "piano, ambient",
duration_s: 120,
audio_format: "m4a"
})
});
console.log(await response.json());
{
"code": 200,
"data": [
{"status": "submitted", "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"}
]
}
Dieser Endpunkt erstellt ein Cover direkt aus einer öffentlichen Audio-URL;
uploadTask muss nicht zuvor aufgerufen werden. Er gibt task_id zurück; fragen Sie das Ergebnis über GET /v1/music/tasks/{task_id} ab.curl --request POST \
--url https://api.apimart.ai/v1/music/generations/uploadCover \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"version": "v6",
"audio_url": "https://example.com/reference.mp3",
"custom": true,
"instrumental": true,
"tags": "piano, ambient",
"duration_s": 120,
"variety": "normal",
"audio_format": "m4a"
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/music/generations/uploadCover",
headers={"Authorization": "Bearer <token>"},
json={
"model": "suno",
"version": "v6",
"audio_url": "https://example.com/reference.mp3",
"custom": True,
"instrumental": True,
"tags": "piano, ambient",
"duration_s": 120,
"audio_format": "m4a",
},
)
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/music/generations/uploadCover", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "suno",
version: "v6",
audio_url: "https://example.com/reference.mp3",
custom: true,
instrumental: true,
tags: "piano, ambient",
duration_s: 120,
audio_format: "m4a"
})
});
console.log(await response.json());
Authorizations
string
erforderlich
Bearer Token. Den API-Key erhalten Sie auf der API-Key-Verwaltungsseite.
Body
string
Standard:"suno"
Verwenden Sie immer
suno.string
erforderlich
Direkte, öffentlich erreichbare HTTP(S)-URL zu einer Audiodatei. Das Quellaudio muss kürzer als 8 Minuten sein. Lokale Pfade,
blob:-URLs und Links mit Anmeldung werden nicht unterstützt.string
Standard:"v6"
Öffentliche Version:
v6 / v6-wild / v6-mini. Standard ist v6; bei Verwendung von custom_model_id weglassen.string
Vollständige UUID aus der Modellerstellungsaufgabe. Kann nicht mit
version oder persona_id verwendet werden.boolean
Senden Sie dieses Feld ausdrücklich. Verwenden Sie bei
false gpt_description, bei true die Felder für Liedtext und Stil.boolean
Standard:"false"
Ob instrumentales Audio erzeugt wird. Bei
custom=true und false für dieses Feld ist prompt erforderlich.string
Inspirationsbeschreibung. Erforderlich bei
custom=false; maximal 3.000 Zeichen.string
Benutzerdefinierter Liedtext mit bis zu 5.000 Zeichen.
string
Stilbeschreibung mit bis zu 1.000 Zeichen.
string
Titel mit bis zu 80 Zeichen.
string
Auszuschließende Stile.
number
Stilgewichtung von 0 bis 1.
number
Kreativitätsgewichtung von 0 bis 1.
number
Audiogewichtung von 0 bis 1.
boolean
Ob der eingegebene Liedtext kreativ umgeschrieben wird.
string
Stimmgeschlecht:
Male / Female.string
Persona-ID; kann nicht zusammen mit
custom_model_id verwendet werden.integer
Zieldauer der Generierung von 10 bis 360 Sekunden. Nur im benutzerdefinierten Modus verfügbar.
string
Stilvariation:
off / normal / high / extra / max.boolean
Standard:"false"
Aktiviert den Max-Modus. Erfordert den benutzerdefinierten Modus und wird zum Doppelten des Standardpreises abgerechnet.
string
Ausgabeformat:
mp3 / m4a / wav.Response
integer
Antwortstatuscode.
array
Übermittlungsergebnis. Lesen Sie
data[0].task_id und fragen Sie die Aufgabe ab.{
"code": 200,
"data": [
{"status": "submitted", "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"}
]
}