マーケットサポート← アプリに戻る

Suno API

Suno API モデルは統一された非同期ジョブ API で呼び出します。POST /api/generate でタスクを開始し、完了するまで GET /api/generate/{taskId} をポーリングします。このファミリーは 3 個のエンドポイントを提供します。

代表的な slug
このファミリーの正確な model slug は例として示しています。最新の値はライブのモデルマーケットで確認してください。

概要

すべてのエンドポイントは同じ外枠を共有し、変わるのは model と input フィールドだけです。モデルマーケットの playground から任意に実行できます。

認証

/api-keys で API キーを作成し、Bearer トークンとして送信します。ログイン中のブラウザからのリクエストはセッション cookie 経由でも動作します。

Authorization: Bearer <YOUR_API_KEY>

タスクの作成

POST
POST https://97ai.97claude.com/api/generate

ボディ：{ "model": "<slug>", "input": { … } }

レスポンス：{ "taskId": "<id>", "state": "waiting" }

結果の照会

GET
GET https://97ai.97claude.com/api/generate/<taskId>

レスポンス：{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

非同期
タスク作成の 200 は、タスクが受理されたことを意味するだけで、完了ではありません。state が success または fail になるまでこのエンドポイントをポーリングしてください。失敗したタスクは課金されません。

エンドポイント

モデルタスクmodel slug
Suno v5Text to Musicsuno/v5
Suno v4.5Text to Musicsuno/v4-5
Suno LyricsText to Musicsuno/lyrics

Suno v5 · Text to Music

POSTText to Musicsuno/v5
input フィールド
promptstring必須

Text prompt describing the desired output.

例
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/v5",
    "input": { "prompt": "a red panda surfing" }
  }'

Suno v4.5 · Text to Music

POSTText to Musicsuno/v4-5
input フィールド
promptstring必須

Text prompt describing the desired output.

例
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/v4-5",
    "input": { "prompt": "a red panda surfing" }
  }'

Suno Lyrics · Text to Music

POSTText to Musicsuno/lyrics
input フィールド
promptstring必須

Text prompt describing the desired output.

例
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/lyrics",
    "input": { "prompt": "a red panda surfing" }
  }'