楽曲商用利用許諾書 API

2026-09-18 更新 · Suno-API チーム

インターフェースの説明

楽曲商用利用許諾書のエンドポイントは、現在の API Key が属するユーザーが許諾できる楽曲の照会、PDF 許諾書の生成、許諾書履歴の照会、発行済みファイルのダウンロードを行います。

すべてのエンドポイントは New API Key を共通で使用します。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

ベースアドレス：

https://www.suno-api.io

利用前提

• API Key が有効で、許諾書を発行する必要があるユーザーに属していること。
• 先に許諾アイデンティティの紐付けを完了する必要があります（下記「0. 許諾資格とアイデンティティ」）。一度確定すると、製品ルールに従ってロックされます。
• 個人または法人の累計チャージ資格を満たしている必要があります。
• 通常のエンドポイントはマスクされたアイデンティティ情報のみを返し、身分証番号・電話番号・統一社会信用コードなどの平文は返しません。
• 1 曲につき発行できる許諾書は 1 通のみです。生成に失敗した許諾書は、その楽曲の資格を消費しません。
• 現在サポートされるのは、完了済みで音声があり、実際の Suno Song ID を持つ指定の生成タイプです。選択可能かどうかは楽曲リストの authorization.selectable に従います。

0. 許諾資格とアイデンティティ

許諾書を発行する前に、資格を照会してアイデンティティを紐付ける必要があります。この 2 つのエンドポイントはいずれも無料です。

0.1 許諾資格とアイデンティティ状態の照会

エンドポイント: GET /api/music/authorization/context

{
  "code": 200,
  "message": "success",
  "data": {
    "identity": {
      "exists": false
    },
    "eligibility": {
      "current_amount": 216.3,
      "personal_required_amount": 200,
      "company_required_amount": 500,
      "personal_eligible": true,
      "company_eligible": false
    },
    "stats": {
      "authorized_song_count": 0,
      "certificate_count": 0
    }
  }
}

0.2 許諾アイデンティティの紐付け

エンドポイント: POST /api/music/authorization/identity

{
  "identity_type": "personal",
  "legal_name": "山田太郎",
  "id_number": "110101199001010000",
  "contact_name": "山田太郎",
  "phone": "13800000000",
  "email": "user@example.com",
  "address": "東京都渋谷区",
  "confirm_locked": true
}

レスポンスはマスク済みのアイデンティティ情報（{"identity": {...}}）を返します。紐付けに成功したら、context エンドポイントで identity.exists が true になったことを確認してから、楽曲リストと発行のエンドポイントを呼び出してください。アイデンティティ情報の変更が必要な場合は、カスタマーサポートにお問い合わせください。

1. 許諾可能な楽曲の照会

エンドポイント: GET /api/music/authorization/songs

Query パラメータ

リクエスト例

curl "https://www.suno-api.io/api/music/authorization/songs?p=1&page_size=20&status=selectable" \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス例

{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "task_id": 10001,
        "suno_song_id": "suno-song-id-1",
        "title": "サンプル楽曲",
        "generation_type": "generate",
        "completed_at": 1784000000,
        "created_at": 1783999000,
        "audio_url": "https://example.com/audio.mp3",
        "model_name": "suno-v6",
        "authorization": {
          "selectable": true
        }
      }
    ]
  }
}

authorization.selectable=false の場合、レスポンスは reason_code と reason で許諾できない理由を説明します。すでに許諾書を発行した楽曲は certificate_id と certificate_no も返します。

2. 許諾書の生成

エンドポイント: POST /api/music/authorization/certificates

Body パラメータ

リクエスト例

curl -X POST https://www.suno-api.io/api/music/authorization/certificates \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["suno-song-id-1", "suno-song-id-2"],
    "confirm_risk_terms": true
  }'

レスポンス例

{
  "success": true,
  "message": "",
  "data": {
    "certificate": {
      "id": 101,
      "certificate_no": "CERTIFICATE-NO",
      "verification_code": "VERIFY-CODE",
      "status": "issued",
      "song_count": 2,
      "identity_type_snapshot": "personal",
      "licensee_name_masked": "山*",
      "document_no_masked_snapshot": "11**************34",
      "phone_masked_snapshot": "138****0000",
      "pdf_sha256": "PDF_SHA256",
      "issued_at": 1784000100,
      "created_at": 1784000000,
      "updated_at": 1784000100,
      "download_url": "/api/music/authorization/certificates/101/download",
      "songs": []
    }
  }
}

成功したレスポンスの status は issued です。PDF のレンダリングに失敗した場合、許諾書は failed とマークされ、該当する楽曲は問題を修正した後に再提出できます。

3. 許諾書履歴の照会

エンドポイント: GET /api/music/authorization/certificates

Query パラメータ

リクエスト例

curl "https://www.suno-api.io/api/music/authorization/certificates?p=1&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス構造

レスポンスの data は page、page_size、total、items を含むページングオブジェクトです。items の各要素は許諾書の概要で、その許諾書の楽曲スナップショットを含みます。

4. 許諾書詳細の照会

エンドポイント: GET /api/music/authorization/certificates/:id

パスパラメータ id は許諾書の数値 ID です。このエンドポイントは、現在の API Key が属するユーザー自身の許諾書にのみアクセスできます。

リクエスト例

curl https://www.suno-api.io/api/music/authorization/certificates/101 \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス構造

成功時は data.certificate を返します。フィールドには許諾書番号、ステータス、マスク済み許諾者情報、発行時刻、PDF 検証値、ダウンロードアドレス、許諾楽曲のスナップショットが含まれます。

5. 許諾書 PDF のダウンロード

エンドポイント: GET /api/music/authorization/certificates/:id/download

ダウンロードできるのは issued 状態の許諾書のみです。ダウンロード要求にも有効な API Key が必要で、現在のユーザー自身の許諾書しかダウンロードできません。

リクエスト例

curl https://www.suno-api.io/api/music/authorization/certificates/101/download \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output authorization-certificate.pdf

成功時のレスポンスは application/pdf のファイルストリームで、ファイル名はバックエンドの Content-Disposition に従います。

よくある失敗原因

注意事項

• 楽曲リストが返す suno_song_id を使用し、pending:* のプレースホルダー ID やタスクテーブルの ID は使わないでください。
• ダウンロードアドレスは公開リンクではありません。API Key による認証を外さないでください。
• 許諾書の記録は API Key に対応するユーザーに属し、ユーザーをまたいで照会・ダウンロードはできません。
• 許諾範囲、制限条項、および最終的な PDF の内容は、実際に発行された許諾書に従います。