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
音声をアップロードしてカバーを作成
公開音声 URL をアップロードし、Suno V6 でカバーを作成します
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"}
]
}
このエンドポイントは公開音声 URL から直接カバーを作成するため、事前に
uploadTask を呼び出す必要はありません。task_id が返されるので、GET /v1/music/tasks/{task_id} をポーリングして結果を取得してください。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
必須
Bearer Token。API Key 管理ページ で API Key を取得してください。
Body
string
デフォルト:"suno"
常に
suno を指定します。string
必須
公開アクセス可能な音声ファイルの直接 HTTP(S) URL。参照元音声は 8 分未満にしてください。ローカルパス、
blob: URL、ログインが必要なリンクは使用できません。string
デフォルト:"v6"
公開バージョン:
v6 / v6-wild / v6-mini。既定値は v6 です。custom_model_id を使用する場合は省略してください。string
モデル作成タスクが返す完全な UUID。
version および persona_id と同時に指定できません。boolean
このフィールドは明示的に送信してください。
false では gpt_description、true では歌詞とスタイルのフィールドを使用します。boolean
デフォルト:"false"
インストゥルメンタル音声を生成するかどうか。
custom=true かつこのフィールドが false の場合、prompt は必須です。string
インスピレーションの説明。
custom=false の場合は必須で、最大 3,000 文字です。string
カスタム歌詞。最大 5,000 文字。
string
スタイルの説明。最大 1,000 文字。
string
タイトル。最大 80 文字。
string
除外するスタイル。
number
スタイルの重み。0~1。
number
創造性の重み。0~1。
number
音声の重み。0~1。
boolean
入力した歌詞を創造的に書き換えるかどうか。
string
ボーカルの性別:
Male / Female。string
Persona ID。
custom_model_id と同時に指定できません。integer
目標生成時間。10~360 秒。カスタムモードでのみ使用できます。
string
スタイルの変化:
off / normal / high / extra / max。boolean
デフォルト:"false"
Max モードを有効にします。カスタムモードが必要で、料金は通常価格の 2 倍です。
string
出力形式:
mp3 / m4a / wav。Response
integer
レスポンスステータスコード。
array
送信結果。
data[0].task_id を取得し、タスク照会 API をポーリングしてください。{
"code": 200,
"data": [
{"status": "submitted", "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"}
]
}