Skip to content

🎧 ウォーターマークフリーSuno音楽モデル

  • 2026.02.04 Sunoバージョンsuno-v4.5-allのmv chirp-auk-turbosuno-v3.5と同じ価格です
  • 2025.09.23 Sunoがバージョンv5のmv chirp-crowをサポート
  • 2025.07.17 Sunoがバージョンv4.5+のmv chirp-bluejayをサポート
  • 2025.05.03 Sunoがバージョンv4.5のmv chirp-aukをサポート
  • 2024.12.17 Sunoが全バージョンv4 v3.5 v3.0をサポート — ウォーターマークフリー、延長時間、高並行性、高品質
  • 2024.11.06 Sunoはほぼウォーターマークフリーになりました。ウォーターマーク除去ソリューションがあります。~プロモーション価格は1曲あたり¥0.04まで下がりました(キャンペーンは終了しました)~
  • 2024.03.27 このプラットフォームが音楽モデルsunoをサポート開始
  • 2つのモードで利用可能:chat非公式API — 推奨:非公式API
  • chatモードはOpenAI形式に準拠。非公式APIについては非公式Suno APIを参照
  • 1つのプロンプトで2曲生成されます
  • 課金はリクエストごとで、曲ごとではありません
  • 試すにはhttps://suno.ddaiai.comにアクセスし、以下のオンライン試用を参照してください

バージョンと機能

バージョンmvリリース日プロンプト制限タグ制限最大曲長
v5chirp-crow2025.09.23500010008分
v4.5+chirp-bluejay2025.07.17500010008分
v4.5-allchirp-auk-turbo2025.05.03500010004分
v4.5chirp-auk2025.05.03500010004分
v4chirp-v42024.12.173000200150秒
v3.5chirp-v3-5---3000200120秒

注意 1. https://suno.ddaiai.comにアクセス(ブロックされている場合は、サブドメインのプレフィックスをsuibianに変更してください)


2. ブロックされている場合は、URLを自分で変更できます — https://suibian.ddaiai.comsuibianを他のものに置き換えてください。例:https://2025.ddaiai.com — すべてのサブドメインがアクセス可能です

オンライン試用

cover

結果プレビュー: cover

Suno API

歌詞タスク作成

post https://api.openai-hk.com/sunoapi/generate/lyrics/

リクエストボディ

json
{ "prompt": "ocean" }
{ "prompt": "ocean" }

レスポンス

json
{ "id": "9561baee-2d64-48fe-8318-d7e82e86712b" }
{ "id": "9561baee-2d64-48fe-8318-d7e82e86712b" }

歌詞タスク作成 V2

post https://api.openai-hk.com/sunoapi/generate/lyrics/

リクエストボディ

  • lyrics_modelremi-v1defaultの値をサポートします
json
{ "prompt": "ocean", "lyrics_model": "remi-v1" }
{ "prompt": "ocean", "lyrics_model": "remi-v1" }

2つの歌詞IDを返します

json
{
  "lyrics_request_id": "e9da46a0-7331-4e7c-bebf-488791033aa8",
  "lyrics_a_id": "281e5626-5165-4de3-83ab-ddea1c4904b1",
  "lyrics_b_id": "a83395f6-f1e4-4655-86db-3d57eeabbe43"
}
{
  "lyrics_request_id": "e9da46a0-7331-4e7c-bebf-488791033aa8",
  "lyrics_a_id": "281e5626-5165-4de3-83ab-ddea1c4904b1",
  "lyrics_b_id": "a83395f6-f1e4-4655-86db-3d57eeabbe43"
}

各歌詞を個別に取得

get https://api.openai-hk.com/sunoapi/lyrics/{lyrics_a_id}

2番目の歌詞

get https://api.openai-hk.com/sunoapi/lyrics/{lyrics_b_id}

歌詞を取得

上記のIDを使用して歌詞を取得します

get https://api.openai-hk.com/sunoapi/lyrics/{id}

レスポンス

json
{
  "text": "lyrics content",
  "title": "lyrics title",
  "status": "complete"
}
{
  "text": "lyrics content",
  "title": "lyrics title",
  "status": "complete"
}

曲タスク作成 — カスタムモデル

post https://api.openai-hk.com/sunoapi/generate

リクエストボディ

json
{
  "prompt": "string",
  "mv": "chirp-v4",
  "title": "string",
  "tags": "string",
  "continue_at": 120,
  "continue_clip_id": "string"
}
{
  "prompt": "string",
  "mv": "chirp-v4",
  "title": "string",
  "tags": "string",
  "continue_at": 120,
  "continue_clip_id": "string"
}
パラメータ説明タイプデフォルト
mvモデル。有効な値:chirp-v4 chirp-v3-0 chirp-v3-5 chirp-auk chirp-bluejaystringchirp-v3-5
title曲のタイトルstring
tags曲のスタイルタグ — 複数のスタイルはスペースで区切りますstring
continue_at開始時間(秒)integer(int64)
continue_clip_id前の曲クリップのIDstring

レスポンス

json
{
  "id": "8fb0a232-aef3-4f8a-82ad-72a3fde0bcc6",
  "clips": [
    {
      "id": "e9f2a77a-07d7-444a-a1f7-575477b0ff18",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": "infectious house",
        "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
        "gpt_description_prompt": null,
        "audio_prompt_id": null,
        "history": null,
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": null,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
      "display_name": "MercurialMetronomes303",
      "handle": "mercurialmetronomes303",
      "is_handle_updated": false,
      "avatar_image_url": null,
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-06-06T02:21:26.175Z",
      "status": "submitted",
      "title": "Ocean",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "399f0745-0168-463c-a18a-f681f5711280",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": "infectious house",
        "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
        "gpt_description_prompt": null,
        "audio_prompt_id": null,
        "history": null,
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": null,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
      "display_name": "MercurialMetronomes303",
      "handle": "mercurialmetronomes303",
      "is_handle_updated": false,
      "avatar_image_url": null,
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-06-06T02:21:26.176Z",
      "status": "submitted",
      "title": "Ocean",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "metadata": {
    "tags": "infectious house",
    "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
    "gpt_description_prompt": null,
    "audio_prompt_id": null,
    "history": null,
    "concat_history": null,
    "type": "gen",
    "duration": null,
    "refund_credits": null,
    "stream": true,
    "infill": null,
    "error_type": null,
    "error_message": null
  },
  "major_model_version": "v3",
  "status": "complete",
  "created_at": "2024-06-06T02:21:26.168Z",
  "batch_size": 1
}
{
  "id": "8fb0a232-aef3-4f8a-82ad-72a3fde0bcc6",
  "clips": [
    {
      "id": "e9f2a77a-07d7-444a-a1f7-575477b0ff18",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": "infectious house",
        "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
        "gpt_description_prompt": null,
        "audio_prompt_id": null,
        "history": null,
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": null,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
      "display_name": "MercurialMetronomes303",
      "handle": "mercurialmetronomes303",
      "is_handle_updated": false,
      "avatar_image_url": null,
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-06-06T02:21:26.175Z",
      "status": "submitted",
      "title": "Ocean",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "399f0745-0168-463c-a18a-f681f5711280",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": "infectious house",
        "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
        "gpt_description_prompt": null,
        "audio_prompt_id": null,
        "history": null,
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": null,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
      "display_name": "MercurialMetronomes303",
      "handle": "mercurialmetronomes303",
      "is_handle_updated": false,
      "avatar_image_url": null,
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-06-06T02:21:26.176Z",
      "status": "submitted",
      "title": "Ocean",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "metadata": {
    "tags": "infectious house",
    "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
    "gpt_description_prompt": null,
    "audio_prompt_id": null,
    "history": null,
    "concat_history": null,
    "type": "gen",
    "duration": null,
    "refund_credits": null,
    "stream": true,
    "infill": null,
    "error_type": null,
    "error_message": null
  },
  "major_model_version": "v3",
  "status": "complete",
  "created_at": "2024-06-06T02:21:26.168Z",
  "batch_size": 1
}

曲タスク作成 — 説明モデル

post https://api.openai-hk.com/sunoapi/generate または post https://api.openai-hk.com/sunoapi/generate/description-mode (非推奨)

リクエストボディ

json
{
  "gpt_description_prompt": "description content",
  "make_instrumental": false,
  "mv": "chirp-v4",
  "prompt": "description content 2"
}
{
  "gpt_description_prompt": "description content",
  "make_instrumental": false,
  "mv": "chirp-v4",
  "prompt": "description content 2"
}

レスポンス

json
{
  "id": "344ec7d6-c976-4100-9804-f348bbf38422",
  "clips": [
    {
      "id": "0c60de63-fba7-4207-94ea-6a240c64f928",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": null,
        "prompt": "ocean",
        "gpt_description_prompt": "ocean",
        "audio_prompt_id": null,
        "history": null,
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": null,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
      "display_name": "MercurialMetronomes303",
      "handle": "mercurialmetronomes303",
      "is_handle_updated": false,
      "avatar_image_url": null,
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-06-06T02:17:12.340Z",
      "status": "submitted",
      "title": "",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "28f4a72c-6a50-452f-a67c-5ab2354512c7",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": null,
        "prompt": "ocean",
        "gpt_description_prompt": "ocean",
        "audio_prompt_id": null,
        "history": null,
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": null,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
      "display_name": "MercurialMetronomes303",
      "handle": "mercurialmetronomes303",
      "is_handle_updated": false,
      "avatar_image_url": null,
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-06-06T02:17:12.340Z",
      "status": "submitted",
      "title": "",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "metadata": {
    "tags": null,
    "prompt": "ocean",
    "gpt_description_prompt": "ocean",
    "audio_prompt_id": null,
    "history": null,
    "concat_history": null,
    "type": "gen",
    "duration": null,
    "refund_credits": null,
    "stream": true,
    "infill": null,
    "error_type": null,
    "error_message": null
  },
  "major_model_version": "v3",
  "status": "complete",
  "created_at": "2024-06-06T02:17:12.330Z",
  "batch_size": 1
}
{
  "id": "344ec7d6-c976-4100-9804-f348bbf38422",
  "clips": [
    {
      "id": "0c60de63-fba7-4207-94ea-6a240c64f928",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": null,
        "prompt": "ocean",
        "gpt_description_prompt": "ocean",
        "audio_prompt_id": null,
        "history": null,
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": null,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
      "display_name": "MercurialMetronomes303",
      "handle": "mercurialmetronomes303",
      "is_handle_updated": false,
      "avatar_image_url": null,
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-06-06T02:17:12.340Z",
      "status": "submitted",
      "title": "",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "28f4a72c-6a50-452f-a67c-5ab2354512c7",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": null,
        "prompt": "ocean",
        "gpt_description_prompt": "ocean",
        "audio_prompt_id": null,
        "history": null,
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": null,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
      "display_name": "MercurialMetronomes303",
      "handle": "mercurialmetronomes303",
      "is_handle_updated": false,
      "avatar_image_url": null,
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-06-06T02:17:12.340Z",
      "status": "submitted",
      "title": "",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "metadata": {
    "tags": null,
    "prompt": "ocean",
    "gpt_description_prompt": "ocean",
    "audio_prompt_id": null,
    "history": null,
    "concat_history": null,
    "type": "gen",
    "duration": null,
    "refund_credits": null,
    "stream": true,
    "infill": null,
    "error_type": null,
    "error_message": null
  },
  "major_model_version": "v3",
  "status": "complete",
  "created_at": "2024-06-06T02:17:12.330Z",
  "batch_size": 1
}

曲を取得

上記のレスポンスにはいずれも2つのIDを含むclipsが返されます:clipsId1、clipsId2

get https://api.openai-hk.com/sunoapi/feed/clipsId1,clipsId2

レスポンス

json
[
  {
    "id": "e9f2a77a-07d7-444a-a1f7-575477b0ff18",
    "video_url": "",
    "audio_url": "https://audiopipe.suno.ai/?item_id=e9f2a77a-07d7-444a-a1f7-575477b0ff18",
    "image_url": "https://cdn1.suno.ai/image_e9f2a77a-07d7-444a-a1f7-575477b0ff18.png",
    "image_large_url": "https://cdn1.suno.ai/image_large_e9f2a77a-07d7-444a-a1f7-575477b0ff18.png",
    "is_video_pending": false,
    "major_model_version": "v3",
    "model_name": "chirp-v3",
    "metadata": {
      "tags": "infectious house",
      "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
      "gpt_description_prompt": null,
      "audio_prompt_id": null,
      "history": null,
      "concat_history": null,
      "type": "gen",
      "duration": null,
      "refund_credits": null,
      "stream": true,
      "infill": null,
      "error_type": null,
      "error_message": null
    },
    "is_liked": false,
    "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
    "display_name": "MercurialMetronomes303",
    "handle": "mercurialmetronomes303",
    "is_handle_updated": false,
    "avatar_image_url": null,
    "is_trashed": false,
    "reaction": null,
    "created_at": "2024-06-06T02:21:26.175Z",
    "status": "streaming",
    "title": "Ocean",
    "play_count": 0,
    "upvote_count": 0,
    "is_public": false
  },
  {
    "id": "399f0745-0168-463c-a18a-f681f5711280",
    "video_url": "",
    "audio_url": "https://audiopipe.suno.ai/?item_id=399f0745-0168-463c-a18a-f681f5711280",
    "image_url": "https://cdn1.suno.ai/image_399f0745-0168-463c-a18a-f681f5711280.png",
    "image_large_url": "https://cdn1.suno.ai/image_large_399f0745-0168-463c-a18a-f681f5711280.png",
    "is_video_pending": false,
    "major_model_version": "v3",
    "model_name": "chirp-v3",
    "metadata": {
      "tags": "infectious house",
      "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
      "gpt_description_prompt": null,
      "audio_prompt_id": null,
      "history": null,
      "concat_history": null,
      "type": "gen",
      "duration": null,
      "refund_credits": null,
      "stream": true,
      "infill": null,
      "error_type": null,
      "error_message": null
    },
    "is_liked": false,
    "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
    "display_name": "MercurialMetronomes303",
    "handle": "mercurialmetronomes303",
    "is_handle_updated": false,
    "avatar_image_url": null,
    "is_trashed": false,
    "reaction": null,
    "created_at": "2024-06-06T02:21:26.176Z",
    "status": "streaming",
    "title": "Ocean",
    "play_count": 0,
    "upvote_count": 0,
    "is_public": false
  }
]
[
  {
    "id": "e9f2a77a-07d7-444a-a1f7-575477b0ff18",
    "video_url": "",
    "audio_url": "https://audiopipe.suno.ai/?item_id=e9f2a77a-07d7-444a-a1f7-575477b0ff18",
    "image_url": "https://cdn1.suno.ai/image_e9f2a77a-07d7-444a-a1f7-575477b0ff18.png",
    "image_large_url": "https://cdn1.suno.ai/image_large_e9f2a77a-07d7-444a-a1f7-575477b0ff18.png",
    "is_video_pending": false,
    "major_model_version": "v3",
    "model_name": "chirp-v3",
    "metadata": {
      "tags": "infectious house",
      "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
      "gpt_description_prompt": null,
      "audio_prompt_id": null,
      "history": null,
      "concat_history": null,
      "type": "gen",
      "duration": null,
      "refund_credits": null,
      "stream": true,
      "infill": null,
      "error_type": null,
      "error_message": null
    },
    "is_liked": false,
    "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
    "display_name": "MercurialMetronomes303",
    "handle": "mercurialmetronomes303",
    "is_handle_updated": false,
    "avatar_image_url": null,
    "is_trashed": false,
    "reaction": null,
    "created_at": "2024-06-06T02:21:26.175Z",
    "status": "streaming",
    "title": "Ocean",
    "play_count": 0,
    "upvote_count": 0,
    "is_public": false
  },
  {
    "id": "399f0745-0168-463c-a18a-f681f5711280",
    "video_url": "",
    "audio_url": "https://audiopipe.suno.ai/?item_id=399f0745-0168-463c-a18a-f681f5711280",
    "image_url": "https://cdn1.suno.ai/image_399f0745-0168-463c-a18a-f681f5711280.png",
    "image_large_url": "https://cdn1.suno.ai/image_large_399f0745-0168-463c-a18a-f681f5711280.png",
    "is_video_pending": false,
    "major_model_version": "v3",
    "model_name": "chirp-v3",
    "metadata": {
      "tags": "infectious house",
      "prompt": "[Verse]\nBlue waves crashing on the shore\nSunshine smiling evermore\n\n[Verse 2]\nSailboats drifting far from land\nSalt and sand go hand in hand\n\n[Chorus]\nOh the ocean holds my dreams\nIn its tide sun's golden beams\nLet the sea set me free\nIn its waves I find my peace\n\n[Verse 3]\nSeagulls flying by the pier\nWhispers of the water clear\n\n[Bridge]\nEndless horizon meets my eyes\nWhere the sea and sky collide\n\n[Verse 4]\nMoonlight dances on the waves\nIn the ocean's arms we lay",
      "gpt_description_prompt": null,
      "audio_prompt_id": null,
      "history": null,
      "concat_history": null,
      "type": "gen",
      "duration": null,
      "refund_credits": null,
      "stream": true,
      "infill": null,
      "error_type": null,
      "error_message": null
    },
    "is_liked": false,
    "user_id": "f60cf781-3c2e-4000-918c-73f68de2a28c",
    "display_name": "MercurialMetronomes303",
    "handle": "mercurialmetronomes303",
    "is_handle_updated": false,
    "avatar_image_url": null,
    "is_trashed": false,
    "reaction": null,
    "created_at": "2024-06-06T02:21:26.176Z",
    "status": "streaming",
    "title": "Ocean",
    "play_count": 0,
    "upvote_count": 0,
    "is_public": false
  }
]
  • 監視する主なフィールドは[0].statusです — completeになると生成が完了です
  • statusの値:submitted pending complete streaming queued

曲を連結

post https://api.openai-hk.com/sunoapi/generate/concat

リクエストボディ

json
{
  "clip_id": "拡張後の曲ID",
  "is_infill": false
}
{
  "clip_id": "拡張後の曲ID",
  "is_infill": false
}

返されたid曲を取得エンドポイントで使用してステータスを確認し、結果を取得します。metadata.typeconcatになります

json
{
  "id": "e193aa39-e97b-464d-938f-cd150f7fb05a",
  "video_url": "",
  "audio_url": "",
  "image_url": "https://cdn1.suno.ai/image_ea8b867f-d072-4a13-9418-eb687cfd956f.png",
  "image_large_url": "https://cdn1.suno.ai/image_large_ea8b867f-d072-4a13-9418-eb687cfd956f.png",
  "is_video_pending": false,
  "major_model_version": "v3.5",
  "model_name": "chirp-v3.5",
  "metadata": {
    "tags": "romantic country",
    "prompt": "[Verse]\nIn the dream of red mansions\nDeep in the quiet night\nCandlelight flickering\n\n[Verse 2]\nDancers among the flowers\nTelling stories of farewell\nSorrow hidden in the heart\n\n[Chorus]\nThe dream of red mansions shattered\nWho awakens from the dream\nHelpless and silent\n\n[Verse 3]\nThe past like smoke\nWind scatters the clouds\nOnly longing remains\n\n[Bridge]\nDreams rise and fall\nWhere to search\nFor that old affection\n\n[Chorus]\nThe dream of red mansions shattered\nWho awakens from the dream\nHelpless and silent\n\n[Verse]\nNightfall descends upon the city\nStreet lights illuminate the dark\nDreams awaken, crowds emerge\nHeartbeat follows the rhythm\n\n[Verse 2]\nNeon lights shine bright\nSilence whispers in my ear\nFootsteps echo all around\nLost, unable to see through\n\n[Chorus]\nThe night makes us dependent\nStarlight lights up the windowsill\nTogether watching the half-hidden moon\nHeartbeat so joyful\n\n[Verse 3]\nMemories in the deep night\nDimly meeting in my mind\nEmbrace soft as the wind\nThe night makes my heart stir\n\n[Chorus]\nThe night makes us dependent\nStarlight lights up the windowsill\nTogether watching the half-hidden moon\nHeartbeat so joyful\n\n[Bridge]\nCold wind cuts through the street\nThoughts take flight with the night\nThis moment dreams have no regrets\nThe night intoxicates deeply",
    "gpt_description_prompt": null,
    "audio_prompt_id": null,
    "history": null,
    "concat_history": [
      {
        "id": "a015205b-43ef-4374-b334-b3a78ef977aa",
        "continue_at": 60,
        "type": "gen",
        "source": "web",
        "infill": false
      },
      {
        "id": "ea8b867f-d072-4a13-9418-eb687cfd956f",
        "continue_at": null
      }
    ],
    "type": "concat",
    "duration": null,
    "refund_credits": null,
    "stream": null,
    "infill": null,
    "has_vocal": null,
    "is_audio_upload_tos_accepted": null,
    "error_type": null,
    "error_message": null
  },
  "is_liked": false,
  "user_id": "7d44c563-4d66-449b-8de1-131e062baf43",
  "display_name": "HeavyHipHop606",
  "handle": "heavyhiphop606",
  "is_handle_updated": false,
  "avatar_image_url": "https://cdn1.suno.ai/defaultPink.jpg",
  "is_trashed": false,
  "reaction": null,
  "created_at": "2024-07-05T07:32:37.286Z",
  "status": "queued",
  "title": "Red Mansion",
  "play_count": 0,
  "upvote_count": 0,
  "is_public": false
}
{
  "id": "e193aa39-e97b-464d-938f-cd150f7fb05a",
  "video_url": "",
  "audio_url": "",
  "image_url": "https://cdn1.suno.ai/image_ea8b867f-d072-4a13-9418-eb687cfd956f.png",
  "image_large_url": "https://cdn1.suno.ai/image_large_ea8b867f-d072-4a13-9418-eb687cfd956f.png",
  "is_video_pending": false,
  "major_model_version": "v3.5",
  "model_name": "chirp-v3.5",
  "metadata": {
    "tags": "romantic country",
    "prompt": "[Verse]\nIn the dream of red mansions\nDeep in the quiet night\nCandlelight flickering\n\n[Verse 2]\nDancers among the flowers\nTelling stories of farewell\nSorrow hidden in the heart\n\n[Chorus]\nThe dream of red mansions shattered\nWho awakens from the dream\nHelpless and silent\n\n[Verse 3]\nThe past like smoke\nWind scatters the clouds\nOnly longing remains\n\n[Bridge]\nDreams rise and fall\nWhere to search\nFor that old affection\n\n[Chorus]\nThe dream of red mansions shattered\nWho awakens from the dream\nHelpless and silent\n\n[Verse]\nNightfall descends upon the city\nStreet lights illuminate the dark\nDreams awaken, crowds emerge\nHeartbeat follows the rhythm\n\n[Verse 2]\nNeon lights shine bright\nSilence whispers in my ear\nFootsteps echo all around\nLost, unable to see through\n\n[Chorus]\nThe night makes us dependent\nStarlight lights up the windowsill\nTogether watching the half-hidden moon\nHeartbeat so joyful\n\n[Verse 3]\nMemories in the deep night\nDimly meeting in my mind\nEmbrace soft as the wind\nThe night makes my heart stir\n\n[Chorus]\nThe night makes us dependent\nStarlight lights up the windowsill\nTogether watching the half-hidden moon\nHeartbeat so joyful\n\n[Bridge]\nCold wind cuts through the street\nThoughts take flight with the night\nThis moment dreams have no regrets\nThe night intoxicates deeply",
    "gpt_description_prompt": null,
    "audio_prompt_id": null,
    "history": null,
    "concat_history": [
      {
        "id": "a015205b-43ef-4374-b334-b3a78ef977aa",
        "continue_at": 60,
        "type": "gen",
        "source": "web",
        "infill": false
      },
      {
        "id": "ea8b867f-d072-4a13-9418-eb687cfd956f",
        "continue_at": null
      }
    ],
    "type": "concat",
    "duration": null,
    "refund_credits": null,
    "stream": null,
    "infill": null,
    "has_vocal": null,
    "is_audio_upload_tos_accepted": null,
    "error_type": null,
    "error_message": null
  },
  "is_liked": false,
  "user_id": "7d44c563-4d66-449b-8de1-131e062baf43",
  "display_name": "HeavyHipHop606",
  "handle": "heavyhiphop606",
  "is_handle_updated": false,
  "avatar_image_url": "https://cdn1.suno.ai/defaultPink.jpg",
  "is_trashed": false,
  "reaction": null,
  "created_at": "2024-07-05T07:32:37.286Z",
  "status": "queued",
  "title": "Red Mansion",
  "play_count": 0,
  "upvote_count": 0,
  "is_public": false
}

オーディオからオーディオ生成

https://suno.ddaiai.com で試すことができます — 以下のプレビューを参照してください

suno

APIは6つのステップで構成されています

1. アップロードリクエスト

post https://api.openai-hk.com/sunoapi/uploads/audio

リクエストボディ

json
{ "extension": "mp3" }
{ "extension": "mp3" }

レスポンス

json
{
  "id": "c25a8c59-000a-481f-ac28-efde2dc9e677",
  "url": "https://suno-uploads.s3.amazonaws.com/",
  "fields": {
    "Content-Type": "audio/mpeg",
    "key": "raw_uploads/c25a8c59-000a-481f-ac28-efde2dc9e677.mp3",
    "AWSAccessKeyId": "AKIA2V4GXGDKJMTPWLXO",
    "policy": "eyJleHBpcmF0aW9uIjogIjIwMjQtMDYtMTdUMDY6MTg6MzJaIiwgImNvbmRpdGlvbnMiOiBbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDAsIDEwNDg1NzYwMF0sIFsic3RhcnRzLXdpdGgiLCAiJENvbnRlbnQtVHlwZSIsICJhdWRpby9tcGVnIl0sIHsiYnVja2V0IjogInN1bm8tdXBsb2FkcyJ9LCB7ImtleSI6ICJyYXdfdXBsb2Fkcy9jMjVhOGM1OS0wMDBhLTQ4MWYtYWMyOC1lZmRlMmRjOWU2NzcubXAzIn1dfQ==",
    "signature": "yjfB/HTNgPHURNLRdeizNMVgG6k="
  }
}
{
  "id": "c25a8c59-000a-481f-ac28-efde2dc9e677",
  "url": "https://suno-uploads.s3.amazonaws.com/",
  "fields": {
    "Content-Type": "audio/mpeg",
    "key": "raw_uploads/c25a8c59-000a-481f-ac28-efde2dc9e677.mp3",
    "AWSAccessKeyId": "AKIA2V4GXGDKJMTPWLXO",
    "policy": "eyJleHBpcmF0aW9uIjogIjIwMjQtMDYtMTdUMDY6MTg6MzJaIiwgImNvbmRpdGlvbnMiOiBbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDAsIDEwNDg1NzYwMF0sIFsic3RhcnRzLXdpdGgiLCAiJENvbnRlbnQtVHlwZSIsICJhdWRpby9tcGVnIl0sIHsiYnVja2V0IjogInN1bm8tdXBsb2FkcyJ9LCB7ImtleSI6ICJyYXdfdXBsb2Fkcy9jMjVhOGM1OS0wMDBhLTQ4MWYtYWMyOC1lZmRlMmRjOWU2NzcubXAzIn1dfQ==",
    "signature": "yjfB/HTNgPHURNLRdeizNMVgG6k="
  }
}

ここのidは以下で使用されるaudio_idで、urlはステップ2のリクエストURLです

2. ファイルをアップロード

post https://suno-uploads.s3.amazonaws.com/

shell
curl --request POST \
  --url https://suno-uploads.s3.amazonaws.com/ \
  --header 'content-type: multipart/form-data' \
  --form Content-Type=audio/mpeg \
  --form key=raw_uploads/c25a8c59-000a-481f-ac28-efde2dc9e677.mp3 \
  --form AWSAccessKeyId=AKIA2V4GXGDKJMTPWLXO \
  --form policy=eyJleHBpcmF0aW9uIjogIjIwMjQtMDYtMTdUMDY6MTg6MzJaIiwgImNvbmRpdGlvbnMiOiBbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDAsIDEwNDg1NzYwMF0sIFsic3RhcnRzLXdpdGgiLCAiJENvbnRlbnQtVHlwZSIsICJhdWRpby9tcGVnIl0sIHsiYnVja2V0IjogInN1bm8tdXBsb2FkcyJ9LCB7ImtleSI6ICJyYXdfdXBsb2Fkcy9jMjVhOGM1OS0wMDBhLTQ4MWYtYWMyOC1lZmRlMmRjOWU2NzcubXAzIn1dfQ== \
  --form signature=yjfB/HTNgPHURNLRdeizNMVgG6k= \
  --form file=@/you_mp3_dir_file.mp3
curl --request POST \
  --url https://suno-uploads.s3.amazonaws.com/ \
  --header 'content-type: multipart/form-data' \
  --form Content-Type=audio/mpeg \
  --form key=raw_uploads/c25a8c59-000a-481f-ac28-efde2dc9e677.mp3 \
  --form AWSAccessKeyId=AKIA2V4GXGDKJMTPWLXO \
  --form policy=eyJleHBpcmF0aW9uIjogIjIwMjQtMDYtMTdUMDY6MTg6MzJaIiwgImNvbmRpdGlvbnMiOiBbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDAsIDEwNDg1NzYwMF0sIFsic3RhcnRzLXdpdGgiLCAiJENvbnRlbnQtVHlwZSIsICJhdWRpby9tcGVnIl0sIHsiYnVja2V0IjogInN1bm8tdXBsb2FkcyJ9LCB7ImtleSI6ICJyYXdfdXBsb2Fkcy9jMjVhOGM1OS0wMDBhLTQ4MWYtYWMyOC1lZmRlMmRjOWU2NzcubXAzIn1dfQ== \
  --form signature=yjfB/HTNgPHURNLRdeizNMVgG6k= \
  --form file=@/you_mp3_dir_file.mp3
  • リクエストボディは上記のfieldsfile(mp3ファイル)を加えたものです
  • 20xレスポンスは成功を示します

3. アップロード完了を報告

post https://api.openai-hk.com/sunoapi/uploads/audio/{id}/upload-finish

リクエストボディ

json
{ "upload_type": "file_upload", "upload_filename": "you_mp3_name.mp3" }
{ "upload_type": "file_upload", "upload_filename": "you_mp3_name.mp3" }

4. 処理ステータスを確認

get https://api.openai-hk.com/sunoapi/uploads/audio/{id}

レスポンスボディ

json
{
  "id": "c25a8c59-000a-481f-ac28-efde2dc9e677",
  "status": "complete",
  "error_message": null,
  "s3_id": "m_05c9b477-4519-4810-9ffa-00580c082067",
  "title": "S-100096-100096-84069F8B",
  "image_url": "https://cdn1.suno.ai/image_05c9b477-4519-4810-9ffa-00580c082067.png"
}
{
  "id": "c25a8c59-000a-481f-ac28-efde2dc9e677",
  "status": "complete",
  "error_message": null,
  "s3_id": "m_05c9b477-4519-4810-9ffa-00580c082067",
  "title": "S-100096-100096-84069F8B",
  "image_url": "https://cdn1.suno.ai/image_05c9b477-4519-4810-9ffa-00580c082067.png"
}

statuscompleteの場合、処理が完了しています

5. オーディオクリップを初期化

post https://api.openai-hk.com/sunoapi/uploads/audio/{id}/initialize-clip

リクエストボディ

json
{}
{}

レスポンスボディ

json
{
  "clip_id": "05c9b477-4519-4810-9ffa-00580c082067"
}
{
  "clip_id": "05c9b477-4519-4810-9ffa-00580c082067"
}

6. 取得とリミックス

  • 上記のclip_ididとして曲を取得エンドポイントを使用します
  • 非推奨:曲タスク作成 — カスタムモデルを使用し、continue_clip_idclip_idの値を入力し、mvchirp-v3-5-uploadに設定します
  • 異なるバージョンを使用する場合:
json
{
  "prompt": "lyrics",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-v4",
  "title": "title",
  "continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
  "continue_at": 10,
  "task": "upload_extend"
}
{
  "prompt": "lyrics",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-v4",
  "title": "title",
  "continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
  "continue_at": 10,
  "task": "upload_extend"
}

オーディオからオーディオ生成 — URLアップロード

  • 上記のオーディオからオーディオ方法はかなり煩雑です
  • 以下のエンドポイントは上記のすべてのステップを1回の呼び出しで処理します
  • mp3のみサポート
  • リソース集約的 — 200クレジット消費

post https://api.openai-hk.com/sunoapi/uploads/audio-url

リクエストボディ

json
{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}
{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}

レスポンスボディ

json
{
  "clip_id": "f4e624c0-b018-4933-8f35-be2bcc79a0c8",
  "code": "success",
  "data": "f4e624c0-b018-4933-8f35-be2bcc79a0c8",
  "message": ""
}
{
  "clip_id": "f4e624c0-b018-4933-8f35-be2bcc79a0c8",
  "code": "success",
  "data": "f4e624c0-b018-4933-8f35-be2bcc79a0c8",
  "message": ""
}
  • 返されたclip_idをリミックスに使用 — 6. 取得とリミックスを参照
  • newapi形式と互換性があります — dataclip_idと同じです
  • curlデモ
shell
curl --request POST \
  --url https://api.openai-hk.com/sunoapi/uploads/audio-url \
  --header 'Authorization: Bearer hk-yourKey' \
  --header 'content-type: application/json' \
  --data '{
	"url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}'
curl --request POST \
  --url https://api.openai-hk.com/sunoapi/uploads/audio-url \
  --header 'Authorization: Bearer hk-yourKey' \
  --header 'content-type: application/json' \
  --data '{
	"url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}'

NewAPI互換性

  • A. すでにnewapi形式と互換性があります
  • B. すでにgod形式と互換性があります
  • C. その他の形式の互換性については、カスタマーサポートにお問い合わせください

チャットモード呼び出し

  • チャットモードでモデルsuno-v3を使用して呼び出します

セットアップ

  • 下の画像のようにフィールドを設定します
  • OpenAI APIエンドポイント: https://api.openai-hk.com
  • OpenAI API KEY: hk-yourApiKey

cover

結果

  • モデルをsuno-v3に設定します cover
  • チャットボックスにプロンプトを入力すると、2つの音楽トラック、歌詞、アルバムカバーが返されます covercover

チャット統合デモ

すでにOpenAI APIと整合しています — モデルをsuno-v3に変更するだけです

shell
curl --request POST \
  --url https://api.openai-hk.com/v1/chat/completions \
  --header 'Authorization: Bearer hk-yourKey' \
  --header 'content-type: application/json' \
  --data '{
    "max_tokens": 800,
    "model": "suno-v3",
    "temperature": 0.8,
    "top_p": 1,
    "presence_penalty": 1,
    "stream":false,
    "messages": [
        {
            "role": "user",
            "content": "childhood memories"
        }
    ]
}'
curl --request POST \
  --url https://api.openai-hk.com/v1/chat/completions \
  --header 'Authorization: Bearer hk-yourKey' \
  --header 'content-type: application/json' \
  --data '{
    "max_tokens": 800,
    "model": "suno-v3",
    "temperature": 0.8,
    "top_p": 1,
    "presence_penalty": 1,
    "stream":false,
    "messages": [
        {
            "role": "user",
            "content": "childhood memories"
        }
    ]
}'