Get Clip Endpoint

Overview

Retrieves detailed information about a specific audio clip by its ID.

🔗 Quick Links

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

Endpoint

GET /api/clip?id=clip-id
GET /[accountId]/api/clip?id=clip-id

Request

Query Parameters

id (string, required)
ID of the clip to retrieve

Example Request

curl "https://your-domain.com/api/clip?id=a1b2c3d4-e5f6-7890-abcd-ef1234567890"

const response = await fetch('/api/clip?id=a1b2c3d4-e5f6-7890-abcd-ef1234567890');

Response

Success Response (200 OK)

Returns an AudioInfo object:

{
  "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

Bad Request (400)

When id parameter is missing:

{
  "error": "Missing parameter id"
}

Status Code: 400
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

Returns detailed information about a single clip
All responses include CORS headers

← Back to API Documentation