AGTCloud API Docs
ガイドAPIリファレンス連携とリソース更新とヘルプ
音楽生成Suno MJ

参照音声をアップロード

公開アクセス可能な参照音声 URL を送信し、カバー、延長、ボーカル追加で使用するトラック ID を取得します。

この API は JSON の audio_url を受け取ります。Multipart 形式のファイルアップロードではありません。is_async で同期処理または非同期処理を選択します。

POST/suno/mj/submit/upload

認証

bearerAuth
認証Bearer <token>

Authorization: Bearer your-api-key で認証します。

指定位置: header

リクエストボディ

application/json

TypeScript 型定義

TypeScript で request body 型を使用します。

レスポンスボディ

application/json

application/json

アップロード結果の処理

  • 同期アップロード:is_async=false(デフォルト)の場合、成功後に data.music_id からトラック ID を取得します。
  • 非同期アップロード:is_async=true の場合、送信後に data.jobId を保存し、タスクを取得して完了を待ちます。完了後のトラック ID は data.data.data.musics[].musicId にあります。

非同期レスポンスの status: SUCCESS は、タスクが受け付けられたことだけを示し、アップロード処理の完了を意味しません。トラック ID は、スタイルカバー、楽曲を延長、またはボーカルを追加の music_id に指定します。タスク ID をトラック ID の代わりに使用することはできません。