API Doc-CometAPI
English
  • English
  • Русский
HomeDashBoardModel Marketplace
HomeDashBoardModel Marketplace
Discord_Support
English
  • English
  • Русский
  1. Suno
  • How to Use CometAPI?
  • 🚀 Overview
    • Quick Start
    • Important Guidelines
    • Release Notes
    • Quickly request CometAPI via ApiDog
    • Models
  • 💬 Text Models
    • Chat
    • Responses
    • Anthropic Messages
    • Gemini Generating Content
    • Embeddings
  • 🖼️ Image Models
    • OpenAI
      • gpt-4o-image generates image
      • Images
      • Image Editing (gpt-image-1)
    • Gemini
      • Guide to calling gemini-3-pro-image (Nano Banana)
      • Gemini generates image
    • Midjourney
      • Midjourney Quick Start: Complete Image Generation Workflow in One Go
      • Task Fetching API
        • List by Condition
        • Fetch Single Task (most recommended)
      • Imagine
      • Submit Video
      • Submit Editor
      • Action (UPSCALE; VARIATION; REROLL; ZOOM, etc.)
      • Blend (image -> image)
      • Describe (image -> text)
      • Modal (Area Redesign & Zoom)
    • Replicate(image)
      • Create Predictions - General
      • replicate query
    • seededit/seedream
      • bytedance-Image Editing (seededit)
      • bytedance-image-generation(seedream)
    • bria
      • Generate Image
      • Generate Vector Graphics - Base (Beta)
      • Image Editing
      • Query Status
    • Hunyuan3D
  • 📺 Video Models
    • sora-2
      • official
        • Create video
        • Remix video
        • Retrieve video
        • Retrieve video content
      • self-developed
        • Retrieve video
        • Create video
    • veo3
      • veo3-chat format
      • Submit video generation task
      • Query video generation status
    • kling (video)
      • callback_url
      • Multimodal Video Editing
        • Initialize Video for Editing
        • Add Video Selection
        • Delete Video Selection
        • Clear Video Selection
        • Preview Selected Video Area
        • Create Task
      • Text to Video
      • Image to Video
      • Multi-Image To Video
      • Video Extension
      • Avatar
      • Lip-Sync
      • Video Effects
      • Text to Audio
      • Video to Audio
      • TTS
      • Image Generation
      • Multi-Image to Image
      • Image Expansion
      • Image Recognize
      • Virtual Try-On
      • [Counterpart] Creating Tasks
      • lip sync
      • Individual queries
    • runway(video)
      • official format
        • runway images raw video
        • Generate a video from a video
        • Generate an image from text
        • Upscale a video
        • Control a character
        • runway to get task details
      • Reverse Format
        • generate(text)
        • generate(Reference images)
        • Video to Video Style Redraw
        • Act-one Expression Migration
        • feed-get task
    • bytedance
      • bytedance-video
      • bytedance-video get
    • MiniMax Conch(video)
      • MiniMax Conch Official Documentation
      • MiniMax Conch Generation
      • MiniMax Conch Query
      • MiniMax Conch Download
  • 🎵 Music Models
    • Suno
      • Setting suno Version
      • Suno API Scenario Application Guide
      • Generate lyrics
        POST
      • Generate music clip
        POST
      • Upload clip
        POST
      • Submit concatenation
        POST
      • Full Track Audio Separation
        POST
      • Single Track Audio Separation
        POST
      • Create New Persona
        POST
      • add style tags
        POST
      • Single task query
        GET
      • Generate mp4 mv video
        GET
      • Timing: lyrics, audio timeline
        GET
      • Get wav format file
        GET
      • Get midi
        GET
      • Batch query tasks
        POST
  • 🔊 Audio Models
    • Realtime
    • Create speech
    • Create transcription
    • Create translation
  • 🧩 Integration Guides
    • LiteLLM
    • Dify
    • Make
    • n8n
    • Lobe-Chat
    • COZE
    • Zapier
    • Activepieces
    • LlamaIndex
    • Continue
    • FlowiseAI
    • Chatbox
    • CherryStudio
    • AnythingLLM
    • LangChain
    • BuildShip
    • gptme
    • Immersive Translation
    • Cline
    • Eudic Translation
    • ChatHub
    • OpenAI Translator
    • ChatAll Translation
    • Pot Translation
    • Zotero
    • NEXT CHAT (ChatGPT Next Web)
    • Obsidian's Text Generator Plugin
    • librechat
    • utools-ChatGPT Friend
    • avante.nvim
    • Open WebUI
    • GPT Academic Optimization (gpt_academic)
    • OpenManus
    • IntelliJ Translation Plugin
    • FastGPT
    • n8n Local Deployment
  • ⚠️ Errors
    • Error Codes & Handling
  • 📝 Code Examples
    • Text-to-Image Generation
    • Image-to-image generation URL upload
    • Regular Post Text Conversation
    • OpenAI Official Library Usage Example
    • Streamed Output
    • Json Fixed Format Output Code Display
    • Embedding code example
    • o1-preview Model Code Example
    • LangChain Usage Example (Successful Test Date: 2024-11-25)
    • Openai dall-e-3 & flux series drawing model
    • gpt, claude, gemini multimodal network image parsing example
    • Multimodal PDF File Parsing Examples for GPT, Claude, and Gemini
    • Code example
  • 🏄🏼‍♀️ Best Practices
    • Midjourney Best Practices
    • Retry Logic Documentation for CometAPI and OpenAI Official API
    • Runway Best Practices
    • Claude Code Installation and Usage Guide
    • Gemini CLI Installation and Usage Guide
    • Codex Usage Guide
    • CometAPI Account Balance Query API Usage Instructions
  • 💳 Pricing & Billing
    • About Pricing
  • 🤝🏼 Support
    • Help Center
    • Interface Stability
    • Privacy policy
    • Terms of service
    • Common Misconceptions
    • Confusion about use
  1. Suno

add style tags

POST
https://api.cometapi.com/suno/act/tags
Maintainer:Not configured
The /suno/act/tags endpoint helps you generate detailed, professional music style descriptions from simple keywords or basic style tags. If you're unsure how to write effective style tags for music generation, this endpoint will expand your simple input into comprehensive style descriptions that produce better music results.
This is particularly useful when you want to create music but don't know the technical terminology or detailed style descriptions needed for the Generate music clip endpoint.

How It Works#

You provide a simple keyword or basic style tag (like "student", "rock", "happy"), and the API returns a detailed, professional music production description including:
Instrumentation details (guitars, synths, drums, etc.)
Arrangement structure (verses, chorus, bridge)
Sonic characteristics (grooves, textures, energy levels)
Production techniques and effects

Use Cases#

Converting simple concepts into professional music style descriptions
Learning what makes effective style tags for music generation
Improving music generation quality by using detailed style descriptions
Exploring different interpretations of basic style keywords
Helping non-musicians describe the music they want to create

Tips#

Start with simple, clear keywords that describe mood, genre, or theme
The expanded description can be further customized before using it in music generation
Try different variations of your original tag to explore different style interpretations
Use the expanded tags to learn professional music production terminology

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.cometapi.com/suno/act/tags' \
--header 'Authorization: Bearer ' \
--header 'myuid: 123' \
--header 'Content-Type: application/json' \
--data-raw '{"original_tags":"student"}'
Response Response Example
{
    "upsampled_tags": "Begin with a perky pop groove—clean electric guitar, syncopated claps, and playful synth hooks. Verses ride bouncy keys and tight bass; the chorus explodes with layered harmonies and energetic drums. Bridge drops to minimal keys, rebuilding for a triumphant, upbeat finale.",
    "request_id": "e7af7b14-7afb-4561-9952-e39070dbae93"
}
Modified at 2025-11-24 09:50:04
Previous
Create New Persona
Next
Single task query
Built with