Get Audio Endpoint

Overview

Retrieves audio information by ID(s) or gets a paginated list of audio clips.

🔗 Quick Links

• 📊 Dashboard - Manage accounts, view logs, and monitor system status
• 📚 API Index - Complete API reference

Endpoint

GET /api/get?ids=id1,id2,id3&page=1
GET /[accountId]/api/get?ids=id1,id2,id3&page=1

Request

Query Parameters

ids (string, optional)
Comma-separated list of audio IDs to retrieve

page (number, optional)
Page number for pagination (when ids is not provided)

Example Request

# Get specific audio by IDs
curl "https://your-domain.com/api/get?ids=id1,id2,id3"

# Get paginated list
curl "https://your-domain.com/api/get?page=1"

// Get specific audio
const response = await fetch('/api/get?ids=id1,id2,id3');

// Get paginated list
const response = await fetch('/api/get?page=1');

Response

Success Response (200 OK)

Returns an array of AudioInfo objects:

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "My Song",
    "image_url": "https://cdn.suno.ai/image-12345.png",
    "lyric": "Song lyrics here",
    "audio_url": "https://cdn.suno.ai/audio-12345.mp3",
    "video_url": "https://cdn.suno.ai/video-12345.mp4",
    "created_at": "2025-12-09T14:30:00.000Z",
    "model_name": "chirp-crow",
    "status": "complete",
    "prompt": "Original prompt",
    "type": "music",
    "tags": "pop",
    "duration": "180"
  }
]

Status Code: 200
Content-Type: application/json

Internal Server Error (500)

When an error occurs:

{
  "error": "Internal server error"
}

Status Code: 500
Content-Type: application/json

Method Not Allowed (405)

When using an unsupported HTTP method:

Status Code: 405
Headers: Allow: GET

Notes

• If ids is provided, returns only those specific audio clips
• If ids is not provided, returns a paginated list (page 1 by default)
• All responses include CORS headers