Welcome to Camxora Music API Documentation

Complete Camxora API documentation — Your gateway to affordable and stable AI music API services.

About Camxora API

Camxora API delivers advanced AI music capabilities through easy-to-integrate APIs, including music generation, lyrics creation, audio processing, and video production. Our platform is designed for developers and businesses who need:

99.9% Uptime
Reliable and stable API performance
Affordable Pricing
Transparent, usage-based pricing system
20-Second Streaming Output
Fast delivery with streaming response
High Concurrency
Scalable solutions that grow with your needs
24/7 Support
Professional technical assistance
Watermark-Free
Commercial-ready music generation

Key Features

🚀

Latest AI Music Models

Suno V5_5, V5, V4.5 Plus, V4.5 All, V4.5, V4. Supports creation of both vocal and instrumental tracks, music extension, and multi-format downloads.

💎

Watermark-Free Commercial Use

All music generated through our API is watermark-free, immediately suitable for commercial projects.

⚡

20-Second Streaming Output

Rapid delivery with streaming output enables real-time applications and live content creation.

🏗️

High-Concurrency Architecture

Built to handle multiple simultaneous requests with reliable performance under heavy traffic.

💰

Transparent and Affordable Pricing

Cost-effective and transparent pricing plans accessible to creators and enterprises.

🔧

Comprehensive Developer Support

Detailed, developer-friendly API documentation backed by an experienced technical team.

Getting Started

Sign Up — Create your free account at Camxora Music API.
Get API Key — Obtain your authentication credentials from the API Key Management Page.
Choose Your API — Select from our comprehensive API collection below.
Follow Quick Start — Use the Quick Start Guide for rapid integration.
Test & Deploy — Verify your integration and go live.

API Base URL

All API requests should be sent to:

https://musicapi.camxora.com# or http://localhost:3000 during local dev (API backend)

✓ In production deployments this value is automatically derived from the host you are visiting — no manual update required when you deploy to musicapi.camxora.com or any other custom domain.

Authentication

All API requests require authentication using a Bearer token:

Authorization: Bearer YOUR_API_KEY

Pass your API key in the Authorization header of every request. You can create and rotate API keys from your dashboard. Your keys carry many privileges, so keep them secure — do not share them in public repositories or client-side code.

AI Model Versions

Camxora Music API supports the following AI music models. You can pass any of the keys below as the model parameter:

Model Label	Model Key	Description
V4	chirp-v4	Improved Vocals — Best audio quality with refined song structure, up to 4 minutes
V4_5	chirp-auk	Smart Prompts — Superior genre blending with smarter prompts, up to 8 minutes
V4_5PLUS	chirp-bluejay	Richer Tones — Enhanced musicality with new creative approaches, up to 8 minutes
V4_5ALL	chirp-auk-turbo	Better Song Structure — V4.5-all is better song structure, max 8 min
V5	chirp-crow	Latest Model — Cutting-edge model with enhanced quality and capabilities
V5_5	chirp-fenix	Voice-Customized Model — Unleash Your Voice: Custom Models Tailored to Your Unique Taste

Quick Start Guide

Step 1 — Check your credits

# Check balance (Camxora native shape)
curl "https://musicapi.camxora.com/v1/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Or use the docs.sunoapi.org compatible alias
curl "https://musicapi.camxora.com/api/v1/get-credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

Step 2 — Generate your first song

# Native /v1/music endpoint
curl -X POST "https://musicapi.camxora.com/v1/music" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gpt_description_prompt": "Upbeat synthwave road trip theme",
    "model": "chirp-crow"
  }'

# Or use the docs.sunoapi.org-compatible alias
curl -X POST "https://musicapi.camxora.com/api/v1/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Upbeat synthwave road trip theme",
    "customMode": false,
    "model": "V5",
    "callBackUrl": "https://your-webhook.example.com/done"
  }'

Poll /v1/task/:id (or the aliased /api/v1/generate/record-info?taskId=) until status is complete, then follow the clip/:id links in the response for playback URLs.

Use Cases

🎬 Media Production

Royalty-free background scores for videos, films, and podcasts with custom moods and genres.

🎮 Game Development

Adaptive procedural soundtracks and level-specific ambient tracks generated on-demand.

📱 Social Content

Viral-ready hooks and trending-style beats for TikTok, Reels, and YouTube Shorts.

🛍️ Advertising

Custom jingles and branded audio identities tailored to campaign briefs.

🎼 Music Education

Arrangement variations, accompaniment tracks, and MIDI transcriptions for learning.

💬 AI Assistants

High-quality TTS-backed musical cues for chat bots, voice skills, and interactive fiction.

Callback Integration

Any POST endpoint that accepts a callback_url (or sunoapi.org alias callBackUrl) will issue a webhook POST to that URL once the job transitions to complete or error.

// Example callback payload (POSTed to your callBackUrl)
{
  "job_id":      "suno_task_01H...",
  "type":        "music",
  "status":      "complete",
  "result":      { "clips": [ { "id": "...", "audio_url": "...", "image_url": "..." } ] },
  "endpoint":    "music",
  "credits":     9
}

Support & Community

Need help? Reach out through your account dashboard for priority 24/7 technical support. We also maintain detailed per-endpoint examples below — every operation is documented with its parameters, cURL example, and response envelope shape.

🎵Music Generation APIs

Generate, extend, cover, mashup, and refine songs

POST/api/v1/generate

Alias of POST /v1/music with sunoapi.org payload schema ({prompt, customMode, style, title, model, callBackUrl, instrumental}).

Param	Required	Description
prompt	required	Text description / lyrics for music generation
customMode	optional	Enable custom parameters mode (true/false)
style	optional	Music style / genre (required in custom mode)
title	optional	Song title (required in custom mode)
instrumental	optional	Generate instrumental only (true/false)
model	optional	Model key: V4 / V4_5 / V4_5PLUS / V4_5ALL / V5 / V5_5 or chirp-*
callBackUrl	optional	Webhook URL for completion

Example request

curl -X POST "https://musicapi.camxora.com/api/v1/generate" \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "Folk song about the sea", "customMode": false, "model": "V4_5ALL" }'
// => { "code": 200, "msg": "success", "data": { "taskId": "suno_task_..." } }

POST/api/v1/generate/extend

Alias of POST /v1/music/extend with sunoapi.org {audioId, continueAt, prompt, model, callBackUrl} payload.

Param	Required	Description
audioId	required	Clip id / audio id to extend
continueAt	optional	Extension start seconds
prompt	optional	Continuation prompt
model	optional	Model key
callBackUrl	optional	Webhook URL

POST/v1/music

Generate music from a description.

Param	Required	Description
gpt_description_prompt	optional	Style/description prompt
prompt	optional	Lyrics prompt (custom mode)
title	optional	Track title
tags	optional	Style tags
negative_tags	optional	Negative tags
instrumental	optional	Generate instrumental only (true/false)
custom_mode	optional	Enable custom mode (prompt+tags+title)
model	optional	Model version key
callback_url	optional	Webhook URL for completion

Example request

curl -X POST https://musicapi.camxora.com/v1/music \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"gpt_description_prompt":"Upbeat synthwave","model":"chirp-crow"}'
// => { "job_id": "...", "status": "pending" }

POST/v1/sounds

Generate a sound effect / audio sample (sounds mode).

Param	Required	Description
prompt	required	Sound description
model	optional	Model version key
loop	optional	Loop or one-shot (true/false)
tempo	optional	BPM (number)
key	optional	Musical key (e.g. "C major")
callback_url	optional	Webhook URL for completion

POST/v1/music/extend

Extend Music — Extend an existing clip.

Param	Required	Description
clip_id	required	Clip to extend
continue_at	optional	Extension start seconds (default 170)
prompt	optional	Optional continuation prompt
model	optional	Model key for the extension

POST/v1/music/cover

Cover Music — Reinterpret existing music in different styles and arrangements.

Param	Required	Description
clip_id	required	Clip to cover
prompt	optional	Style / cover description prompt

POST/v1/music/mashup

Mashup two or more clips together into a single new song.

Param	Required	Description
clip_ids	required	Array of 2+ clip IDs to mashup
prompt	optional	Optional style prompt for the mashup

POST/v1/music/replace-section

Regenerate a specific section [start_s, end_s] of a clip with new lyrics.

Param	Required	Description
clip_id	required	Clip to modify
lyrics	required	New lyrics for the section
start_s	required	Start second
end_s	required	End second (must be > start_s)
prompt	optional	Optional style prompt

POST/v1/music/remaster

Remaster / upsample a clip for higher audio quality.

Param	Required	Description
clip_id	required	Clip to remaster

POST/v1/music/add-vocals

Add Vocals — Generate vocal tracks for instrumental music.

Param	Required	Description
clip_id	required	Instrumental clip to add vocals to
prompt	optional	Optional lyric prompt

POST/v1/music/add-instrumental

Add Instrumental — Create instrumental backing for existing vocal-only clip.

Param	Required	Description
clip_id	required	Vocal clip
prompt	optional	Optional style prompt

POST/v1/music/cover-image

Generate cover art for an existing clip.

Param	Required	Description
clip_id	required	Clip to generate cover art for
prompt	required	Cover art description

POST/v1/generate/upload-extend

Upload and Extend Audio — Upload your own audio and extend it with AI-generated content.

Param	Required	Description
audio_url	optional	Publicly reachable URL to the audio (required when uploaded_clip_id is not set)
uploaded_clip_id	optional	Clip ID returned by upload register endpoint
prompt	optional	Optional prompt for the continuation
continue_at	optional	Start offset seconds (default 170)

POST/v1/generate/upload-cover

Upload and Cover Audio — Transform existing audio with new styles and arrangements.

Param	Required	Description
audio_url	optional	Publicly reachable URL to the audio (required when uploaded_clip_id is not set)
uploaded_clip_id	optional	Clip ID returned by upload register endpoint
prompt	required	Style/cover prompt
cover_start_s	optional	Cover window start seconds (default 0)
cover_end_s	optional	Cover window end seconds (default 60)

✍️Lyrics Creation APIs

Write lyrics and retrieve timestamped lines

POST/api/v1/lyrics

Alias of POST /v1/lyrics accepting sunoapi.org {prompt, callBackUrl} shape.

POST/v1/lyrics

Generate Lyrics — Create AI-powered lyrics for your songs.

Param	Required	Description
prompt	required	Lyrics prompt / theme

Example request

curl -X POST https://musicapi.camxora.com/v1/lyrics \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A song about summer"}'
// => { "job_id": "...", "status": "pending" }

GET/v1/lyrics/:id

Get Timestamped Lyrics — Retrieve lyrics with precise timestamps for synchronization.

🔊Audio Processing APIs

Separate stems, boost, convert to WAV, recovery, MIDI

POST/api/v1/vocal-removal/generate

Alias of POST /v1/music/stems with sunoapi.org {taskId, audioId, callBackUrl} payload.

Param	Required	Description
taskId	optional	Originating task id (optional)
audioId	required	Clip / audio id to separate
callBackUrl	optional	Webhook URL

POST/v1/music/stems

Separate Vocals from Music — Extract vocals and instrumental tracks separately using advanced AI audio separation.

Param	Required	Description
clip_id	required	Clip to separate

POST/v1/music/wav

Convert to WAV Format — Authorize signed WAV download for high-resolution WAV output.

Param	Required	Description
clip_id	required	Clip to download
format	optional	Format: wav (default) or m4a

POST/v1/generate/boost

Boost Music Style — Enhance and refine music styles with AI-powered audio processing.

Param	Required	Description
clip_id	required	Clip to restyle
style_prompt	required	New style description
start_s	optional	Region start seconds (default 0)
end_s	optional	Region end seconds (default 60)

POST/v1/music/recovery

Generate recovery audio (clean-up / restore) for an existing clip.

Param	Required	Description
clip_id	required	Clip to recover
prompt	optional	Optional recovery description prompt

POST/v1/music/midi

Generate a MIDI / instrumental arrangement for a clip.

Param	Required	Description
clip_id	required	Clip to use as reference
prompt	optional	Optional arrangement style prompt

🎬Music Video APIs

Generate MP4 music videos for your clips

POST/v1/mp4/generate

Create Music Video — Generate visual music videos from audio tracks using AI.

Param	Required	Description
clip_id	required	Clip to produce a video for
prompt	optional	Optional music-video visual prompt
quantity	optional	Number of videos (default 1)
aspect_ratio	optional	Aspect ratio: "16:9" (default), "9:16", etc.

Example request

curl -X POST https://musicapi.camxora.com/v1/mp4/generate \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"clip_id":"<clip_uuid>","prompt":"neon city driving at night","aspect_ratio":"16:9"}'

📤Upload Workflow APIs

3-step upload flow for custom audio input

POST/v1/upload/init

Step 1 — create an S3 presigned upload session (returns {id, url, fields}).

Param	Required	Description
extension	required	Audio file extension without dot: mp3, wav, m4a, etc.
upload_type	optional	One of "file_upload" (default), "voice_recording", "song_demo"
last_upload_id	optional	Optional retry-chaining upload id
callback_url	optional	Webhook URL for completion

Example request

curl -X POST https://musicapi.camxora.com/v1/upload/init \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"extension":"mp3","upload_type":"file_upload"}'

POST/v1/upload/register

Step 3 — register the completed S3 upload so Suno processes it and returns a clip_id.

Param	Required	Description
upload_id	required	UUID returned by /v1/upload/init
upload_type	required	Same value as in init (e.g. "file_upload")
upload_filename	required	Original filename of the uploaded file
upload_title	optional	Optional display title
callback_url	optional	Webhook URL for completion

Example request

curl -X POST https://musicapi.camxora.com/v1/upload/register \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"upload_id":"<from-init>","upload_type":"file_upload","upload_filename":"demo.mp3"}'

GET/v1/upload/status/:id

Step 4 — Poll processing status of a registered upload.

🎙Suno Voice APIs

6 operations: phrase → validate → record → generate → apply → extend

POST/v1/persona/create

Create a voice persona (voice clone) from a clip with clear vocals.

Param	Required	Description
clip_id	required	Source clip (up to 60s of clear vocals)
name	required	Persona display name
styles	optional	Optional style tags

POST/v1/voice/phrase

Suno Voice op 1 — generate a reference phrase the user can read for voice-recording validation.

Param	Required	Description
prompt	required	Prompt / context for the phrase generator

Example request

curl -X POST https://musicapi.camxora.com/v1/voice/phrase \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Create a 20 second reading phrase for voice enrollment."}'

POST/v1/voice/validate

Suno Voice op 2 — validate a voice sample (from upload session id or public URL).

Param	Required	Description
upload_id	optional	Upload id returned by /v1/voice/record (required if audio_url not set)
audio_url	optional	Public URL of voice WAV/MP3 sample (required if upload_id not set)

POST/v1/voice/record

Suno Voice op 3 — create a voice-recording upload session.

Param	Required	Description
extension	required	File extension: wav, mp3, m4a

POST/v1/voice/generate

Suno Voice op 4 — create a voice persona (clone) from a processed clip.

Param	Required	Description
clip_id	required	Up-to-60s clip with a single clear voice
name	required	Persona display name
styles	optional	Optional style tags

POST/v1/voice/apply

Suno Voice op 5 — generate new music using a persona / voice clone.

Param	Required	Description
persona_id	optional	Persona id to use
prompt	optional	Lyrics / description prompt
title	optional	Song title
tags	optional	Style tags
model	optional	Model key (chirp-*)

Example request

curl -X POST https://musicapi.camxora.com/v1/voice/apply \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"persona_id":"<persona_uuid>","prompt":"A bright ballad about the sea"}'

POST/v1/voice/extend

Suno Voice op 6 — extend a song further using a persona / voice clone.

Param	Required	Description
persona_id	optional	Persona id to use
continue_at	optional	Extension start seconds (default 170)
prompt	optional	Optional extension prompt

📄Asset Detail APIs

Per-asset GET endpoints: m4a/image/wav/stems/video/cover/subtitle/recovery/mp4/midi

GET/v1/clip/:id

Clip detail — playback URLs (m4a, image), metadata, status.

GET/v1/music/wav/:id

WAV Conversion Detail — Monitor WAV format conversion tasks and download status.

GET/v1/music/stems/:id

Vocal Separation Detail — Check progress and access separated audio files.

GET/v1/music/video/:id

Music Video Detail — Track music video generation progress and retrieve download links.

GET/v1/music/cover/:id

Cover Detail — Monitor the status of music cover tasks and get cover results.

GET/v1/music/subtitle/:id

Subtitle / caption detail — SRT/VTT-format subtitles.

GET/v1/music/recovery/:id

Recovery audio detail — result of a recovery job.

GET/v1/mp4/:id

MP4 task detail — result of a music-video generation job.

GET/v1/music/midi/:id

MIDI detail — result of a MIDI generation job.

🛠️Utility APIs

Credits, task status, sunoapi.org aliases

GET/v1/credits

Get the remaining credits on your API key.

Example request

curl https://musicapi.camxora.com/v1/credits \
  -H "Authorization: Bearer sk_..."

GET/v1/task/:id

Poll a task's status and result.

Example request

curl https://musicapi.camxora.com/v1/task/<job_id> \
  -H "Authorization: Bearer sk_..."
// => { "job_id": "...", "type": "music", "status": "complete", "result": { ... } }

GET/api/v1/get-credits

Alias of GET /v1/credits with sunoapi.org response shape ({code, msg, data.credits}).

Example request

curl "https://musicapi.camxora.com/api/v1/get-credits" -H "Authorization: Bearer sk_..."
// => { "code": 200, "msg": "success", "data": { "credits": 999, "name": "..." } }

GET/api/v1/generate/record-info

Alias of GET /v1/task/:id with sunoapi.org query shape ?taskId= and {code,msg,data:{taskId,status,response}} response.

Example request

curl "https://musicapi.camxora.com/api/v1/generate/record-info?taskId=<taskId>" -H "Authorization: Bearer sk_..."