1. Task Submission
beeswitch docs
  • Plugin Configuration
    • API Relay Setup
    • Claude Code for VS Code Tutorial
    • Claude Code Installation and Usage Guide
    • Gemini CLI Configuration and Usage Guide
    • Codex CLI Configuration Guide
    • OpenCode Integration Configuration Guide
    • N8N Workflow Relay API Usage Guide
  • List Models
    • Models (list models)
      GET
  • OpenAI Format (Supports Major Official Provider Models)
    • Chat (Responses)
      • Create Web Search
      • Create Model Response (GPT-5 Reasoning Enabled)
      • Create Function Call
      • Create Model Response
      • Create Function Call
      • Create Model Response (Streaming)
      • Create Model Response (Control Reasoning Length)
    • ChatGPT APIs
      • ChatGPT Audio
        • Create Video
        • Speech-to-Text gpt-4o-transcribe
        • Create translation (not supported)
        • Speech-to-Text whisper-1
        • Speech-to-Text gpt-4o-transcribe
        • Create speech gpt-4o-mini-tts
        • Create translation (not supported)
      • ChatGPT Chat
        • List Models
        • Create Video with Image
        • Continuously modify and generate videos
        • Create chat picture recognition (streaming) best64
        • Official N test
        • Create Structured Output
        • Control Reasoning Effort
        • Create Chat Function Call
        • deepseek-ocr recognition
        • Create Chat Completion (Non-streaming)
      • ChatGPT Completions
        • Create Completion
    • Images
      • Modify pictures (images)
      • Create Chat Completion (Streaming)
      • Create chat completion qwen-mt-turbo
      • Create chat completion deepseek v3.1 thinking level (streaming)
    • Audio
      • Speech recognition(audio)
      • Speech synthesis (audio)
      • Official Function Calling
      • Create a chat creation graph (non-streaming)
    • Embeddings
      • Text Embeddings
  • Anthropic Format
    • Chat
      POST
    • Chat (prompt cache)
      POST
    • Streaming Response
      POST
    • Chat (Deep Reasoning)
      POST
    • Tool Calling (Function Call)
      POST
    • Tool Calling (MCP) - Pending Support
      POST
    • Analyze Image
      POST
  • Google Gemini APIs
    • Native Format
      • Text-to-Image (Aspect Ratio + Clarity Controls)
      • Generate Image
      • Text Generation
      • Text Generation (Streaming)
      • Text Generation + Reasoning (Streaming)
      • Image Generation
      • Formatted Output
      • Function Calling
      • Document Understanding
      • URL context [native format]
      • Code Execution
      • google search
      • Video Understanding
      • URL context
      • Video understanding-url [native format]
      • Imagen 4 under development
      • Audio Understanding
      • Embeddings
      • Chat
      • Edit Image
    • Image-to-Image Base64 Request (Officially Recommended)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Single Image with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Generation with gemini-2.5-flash-image
      • Image Generation with gemini-2.5-flash-image (Aspect Ratio Control)
      • Image Understanding
    • Image-to-Image URL Request / OpenAI-style URL Request
      • Single Image-to-Image with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Image Understanding
    • Image-to-Image URL Request (Not Currently Supported)
      • Multi-Image Fusion with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Image Understanding
    • Image-to-Image URL Request, Gemini Format (Not Currently Supported)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Image Understanding
  • NanoBanana
    • Image-to-Image Base64 Request (Officially Recommended)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Single Image with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Generation with gemini-2.5-flash-image
      • Image Generation with gemini-2.5-flash-image (Aspect Ratio Control)
      • Image Understanding
    • Gemini Request Format
      • Generate Image
      • Edit Image
    • OpenAI Request Format
      • Edit Image
      • OpenAI Image Format
  • Midjourney Format
    • Task Query API
    • Upload Image
    • Get Seed
    • Submit Imagine Task
    • Query Tasks by ID List
    • Face Swap
    • Execute Action
    • Submit Blend Task
    • Submit Describe Task
    • Submit Modal
    • Refresh URL
    • Edit Image
    • Query Task Status by Task ID
    • Get Seed for Task Image
  • Doubao Video Generation
    • Text-to-Video Example
    • Image-to-Video - First Frame
    • seedance-lite - First and Last Frames
    • Image-to-Video - Base64 Encoding
    • seedance-lite - Reference Image
    • Query Single Task
    • Query video generation task list-default
    • Query video generation task list - search multiple task IDs
  • Doubao Image Generation
    • doubao-seededit-3-0-i2i-250628
    • doubao-seedream-4-0-250828 - Text-to-Image
    • doubao-seedream-4-0-250828 - Image-to-Image
    • doubao-seedream-4-0-250828 - Multi-Image-to-Image
  • Jimeng AI
    • Jimeng AI - Image Generation
      • seedream-4.5
      • seedream-4.5 - Text-to-Image
      • seedream-4.5 - Image-to-Image
      • seedream-4.5 - Multi-Image-to-Image
    • Jimeng AI - Video Generation
      • Unified Task Submission API
      • Unified Query API
  • Rerank Models
    • Rerank
  • Text-to-Music (Suno)
    • Task Submission
      • Generate Song (Inspiration Mode)
        POST
      • Generate Song (Custom Mode)
        POST
      • Generate Song (Continuation Mode)
        POST
      • Generate Song (Singer Style)
        POST
      • Generate Song (Remix Uploaded Song)
        POST
      • Generate Song (Song Concatenation)
        POST
      • Generate Lyrics
        POST
      • Song Concatenation
        POST
    • Query APIs
      • Fetch Tasks in Batch
      • Query Single Task
  • Veo Video Generation
    • Latest Veo Video Generation (Recommended First)
      • Upload Image (Valid for One Day)
      • Create Video Generation Task - Text Only
      • Create Video Generation Task with Reference Image
      • Query Task Status
    • OpenAI Video Format (Recommended)
      • OpenAI Create Video with Image
      • OpenAI Query Task
      • OpenAI Download Video
    • Unified Video Format (Pending Unification)
      • Create Video
      • Create Video with Image
      • Query Task
      • Create Video (Reference Image)
  • Sora Video Generation
    • Official OpenAI Video Format (Recommended)
      • sora-2/sora-2-pro
        • OpenAI Query Task
        • OpenAI Download Video
        • OpenAI Create Video with Image
        • OpenAI Create Video (with Character)
        • OpenAI Edit Video
    • Chat Format
  • Kling (Kuaishou)
    • Text-to-Video
    • Image-to-Video
    • Query tasks (free)
  • Wan (Qwen)
    • Create Video with Image (Wan)
    • Query Video (Wan)
  • MinMax Video Generation
    • Text-to-Video Generation Task (MinMax)
    • Image-to-Video Task (MinMax)
    • Query Video Generation Task Status (MinMax)
    • Video Download (MinMax)
  • Vidu Video Generation
    • Vidu Generate Video
    • Vidu Query
  1. Task Submission

Generate Song (Singer Style)

POST
/suno/submit/music

Access steps#

A. Generate music#

After generating it through the field generation song API, the clip_id value of one of the songs can be obtained: 54834687-5e79-4f08-8e14-cf188f15b598

B. Create a new Persona#

clip_id needs to exist in the system memory, not uploader
It cannot be used across accounts, so the account may not be available if it is offline.

C. Create using persona_id#

Things to note:
mv is chirp-v3-5-tau or chirp-v4-tau
task is artist_consistency
persona_id is obtained in step B
artist_clip_id is clip_id in step A
Can cross accounts

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params

Body Params application/json

Example
{
  "prompt": "[Verse]\nyou from morning to dusk\nAlways warm by my side\nNot afraid of wind or rain\nHold hands tightly and never separate\n\n[Verse 2]\nWith you here I am not alone\nlike stars at night\nNo matter how long the road is, it never feels far\nBecause you are my light\n\n[Chorus]\nHusband, husband, I love you\nyou are the only one in the world\nNo matter where you are in the world\nThe heart follows you like a shadow\n\n[Verse 3]\nyou are my safe haven\nEvery night I dream about you\nNo matter how hard the road ahead is\nEverything is so beautiful with you\n\n[Chorus]\nHusband, husband, I love you\nyou are the only one in the world\nNo matter where you are in the world\nThe heart follows you like a shadow\n\n[Bridge]\nevery moment of life\nWith you by my side, I can experience it\nAll tomorrows are better\nBecause of you I am invincible",
  "generation_type": "TEXT",
  "tags": "electronic, pop",
  "negative_tags": "",
  "mv": "chirp-v4-tau",
  "title": "husband",
  "task": "artist_consistency",
  "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
  "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/suno/submit/music' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "prompt": "[Verse]\nyou from morning to dusk\nAlways warm by my side\nNot afraid of wind or rain\nHold hands tightly and never separate\n\n[Verse 2]\nWith you here I am not alone\nlike stars at night\nNo matter how long the road is, it never feels far\nBecause you are my light\n\n[Chorus]\nHusband, husband, I love you\nyou are the only one in the world\nNo matter where you are in the world\nThe heart follows you like a shadow\n\n[Verse 3]\nyou are my safe haven\nEvery night I dream about you\nNo matter how hard the road ahead is\nEverything is so beautiful with you\n\n[Chorus]\nHusband, husband, I love you\nyou are the only one in the world\nNo matter where you are in the world\nThe heart follows you like a shadow\n\n[Bridge]\nevery moment of life\nWith you by my side, I can experience it\nAll tomorrows are better\nBecause of you I am invincible",
  "generation_type": "TEXT",
  "tags": "electronic, pop",
  "negative_tags": "",
  "mv": "chirp-v4-tau",
  "title": "husband",
  "task": "artist_consistency",
  "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
  "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}'

Responses

🟢200OK
application/json
Bodyapplication/json

Example
{
    "code": "success",
    "data": "950bf3af-78a6-420e-8c01-3bde0bbb3ef9",
    "message": ""
}
Modified at 2026-07-09 10:12:26
Previous
Generate Song (Continuation Mode)
Next
Generate Song (Remix Uploaded Song)
Built with