Skip to main content

​
GET /api/clip

Returns the raw clip data from Suno’s internal /api/clip/{id} endpoint for a given clip ID. Unlike /api/get, this response is not mapped to the AudioInfo format — it returns Suno’s full clip object directly, which contains additional internal fields.
This endpoint uses the SUNO_COOKIE environment variable and does not support per-request cookie override via the Cookie header.

​
Request

​
Query Parameters

​
id
string
required
The clip ID to retrieve.Example: abc123

​
Response

The raw clip object returned by Suno’s API. The exact shape of this object is determined by Suno’s internal API.
The fields in this response are not normalized and may change without notice as Suno updates their platform. For a stable, normalized response, use GET /api/get instead.
Common fields typically present in the clip object include:
​
id
string
Unique identifier for the clip.
​
title
string
Title of the clip.
​
audio_url
string
URL of the audio file.
​
video_url
string
URL of the associated video file.
​
image_url
string
URL of the cover image.
​
status
string
Generation status of the clip.
​
model_name
string
The Suno model used to generate this clip.
​
metadata
object
Internal metadata object. Contains fields such as prompt, tags, duration, type, gpt_description_prompt, and error_message.
​
created_at
string
ISO 8601 timestamp of when the clip was created.

​
Error responses

If the id parameter is missing, the endpoint returns a 400 error: 
{ "error": "Missing parameter id" }

​
Examples

​
Fetch a clip by ID

curl "http://localhost:3000/api/clip?id=abc123"

​
Example response

{
  "id": "abc123",
  "title": "Midnight Drive",
  "audio_url": "https://cdn1.suno.ai/abc123.mp3",
  "video_url": "https://cdn1.suno.ai/abc123.mp4",
  "image_url": "https://cdn1.suno.ai/image_abc123.png",
  "status": "complete",
  "model_name": "chirp-v3-5",
  "created_at": "2024-03-15T22:10:00.000Z",
  "metadata": {
    "prompt": "Neon lights blur past\nThe city never sleeps",
    "tags": "synthwave, moody, electronic",
    "duration": 180,
    "type": "gen",
    "gpt_description_prompt": "a moody synthwave track about driving at night",
    "error_message": null
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us