AudioMusic V2

Documentation Index

Fetch the complete documentation index at: https://docs.audiopod.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Key Capabilities

• Text-to-Music: Generate complete songs with vocals from prompts and lyrics
• Simple Mode: Describe what you want in natural language — AudioMusic V2 handles everything
• Cover / Style Transfer: Transform existing audio into different styles and genres
• Reference Audio: Guide generation using a reference track’s timbre and mixing style
• Audio Analysis: Extract metadata (BPM, key, lyrics, caption) from any audio
• Stem Extraction: Isolate specific instruments (vocals, drums, bass, guitar, and more)
• Repaint / Edit / Extend: Modify specific sections, edit with new prompts, or extend tracks
• Batch Generation: Generate 1-8 variations in a single request
• LRC Timestamps: Synchronized lyric timestamps for karaoke-style playback
• Quality Scoring: Automatic quality assessment for every generation
• 50+ Languages: Generate music with vocals in over 50 languages
• Multiple Formats: Output in WAV, MP3, FLAC, or OGG
• Royalty-Free: All generated music is 100% royalty-free for commercial use

​

Authentication

• API Key (Recommended): X-API-Key: your_api_key header
• JWT Token: Authorization: Bearer your_jwt_token (for session-based auth)

# Example with API Key
curl -X POST "https://api.audiopod.ai/api/v1/music/simple" \
  -H "X-API-Key: $AUDIOPOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "upbeat pop song with catchy melody"}'

​

Quick Start — Simple Mode

from audiopod import AudioPod

client = AudioPod(api_key="ap_your_api_key")

# Simple mode — AudioMusic V2 auto-generates everything
job = client.music.simple(
    query="a soft Bengali love song for a quiet evening",
    wait_for_completion=True
)
print(f"Music URL: {job['output_url']}")

import AudioPod from 'audiopod';

const client = new AudioPod({ apiKey: 'ap_your_api_key' });

// Simple mode — AudioMusic V2 auto-generates everything
const job = await client.music.simple({
  query: 'a soft Bengali love song for a quiet evening',
});
const completed = await client.music.waitForCompletion(job.id);
console.log(`Music URL: ${completed.output_url}`);

# Create job
JOB=$(curl -s -X POST "https://api.audiopod.ai/api/v1/music/simple" \
  -H "X-API-Key: $AUDIOPOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "a soft Bengali love song for a quiet evening"}')

JOB_ID=$(echo $JOB | jq -r '.job.id')
echo "Job created: $JOB_ID"

# Poll for completion
while true; do
  STATUS=$(curl -s "https://api.audiopod.ai/api/v1/music/jobs/$JOB_ID/status" \
    -H "X-API-Key: $AUDIOPOD_API_KEY")
  STATE=$(echo $STATUS | jq -r '.status')
  echo "Status: $STATE"
  [ "$STATE" = "COMPLETED" ] && echo "URL: $(echo $STATUS | jq -r '.output_url')" && break
  [ "$STATE" = "FAILED" ] && echo "Failed" && break
  sleep 5
done

​

Complete Parameters Reference

​

Core Parameters

​

Diffusion Parameters

​

Language Model Parameters

​

Music Metadata Parameters

​

Output & Quality Parameters

​

LoRA Parameters

​

Genre Presets

​

Output Formats

​

Job Lifecycle

1. Submit a generation request → receive a job with status: "PENDING"
2. Poll the job status endpoint → "PROCESSING" while generating
3. Complete → status: "COMPLETED" with output_url and output_urls (multiple formats)
4. Failed → status: "FAILED" with error_message (use retry endpoint to re-queue)

​

Pricing

​

Best Practices

1. Use Simple Mode for quick results — describe what you want in natural language and let AudioMusic V2 handle the details
2. Enable thinking: true (default) for best quality — Chain-of-Thought reasoning significantly improves output
3. Use caption over prompt — AudioMusic V2 uses caption internally; prompt is a legacy alias
4. Set inference_steps: 64 for production quality. Use 32 for fast drafts, 8 for turbo previews
5. Default guidance_scale: 7.0 works well for most cases. Increase to 10-15 for stronger prompt adherence
6. Use structure tags in lyrics — [verse], [chorus], [bridge], [intro], [outro], [Instrumental]
7. Use batch_size > 1 to generate multiple variations and pick the best one
8. Enable generate_lrc: true when you need synchronized lyric timestamps

​

Error Handling

​

Next Steps