Skip to content

Import a song

POST
/v1/songs
curl --request POST \
--url https://api.clipbeat.app/v1/songs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com", "rights_attestation": true, "rights_version": "2026-11-21" }'

Import a song from a link (direct .mp3/.m4a/.wav, Google Drive or Dropbox; Suno links are rejected).

Media typeapplication/json
object
url
required
string format: uri
rights_attestation
required

By sending a song you confirm you own it or have the rights to use it. Finished videos can appear on your Clipbeat page. You can hide any video anytime.

boolean
rights_version
required
string
Allowed value: 2026-11-21

Already imported

Media typeapplication/json
object
id
string format: uuid
title
string | null
duration_sec
number | null
status
string
Allowed values: processing ready
lyrics_status
string
Allowed values: processing ready failed
created_at
string | null format: date-time

Example

{
"status": "processing",
"lyrics_status": "processing"
}

Imported

Media typeapplication/json
object
id
string format: uuid
title
string | null
duration_sec
number | null
status
string
Allowed values: processing ready
lyrics_status
string
Allowed values: processing ready failed
created_at
string | null format: date-time

Example

{
"status": "processing",
"lyrics_status": "processing"
}

Invalid request

Media typeapplication/json
object
error
required
string
message
required
string
topup_url
string
retry_after_sec
integer

Example generated

{
"error": "example",
"message": "example",
"topup_url": "example",
"retry_after_sec": 1
}

Missing, invalid or revoked API key

Media typeapplication/json
object
error
required
string
message
required
string
topup_url
string
retry_after_sec
integer

Example generated

{
"error": "example",
"message": "example",
"topup_url": "example",
"retry_after_sec": 1
}

Key lacks the scope

Media typeapplication/json
object
error
required
string
message
required
string
topup_url
string
retry_after_sec
integer

Example generated

{
"error": "example",
"message": "example",
"topup_url": "example",
"retry_after_sec": 1
}

Rate limited

Media typeapplication/json
object
error
required
string
message
required
string
topup_url
string
retry_after_sec
integer

Example generated

{
"error": "example",
"message": "example",
"topup_url": "example",
"retry_after_sec": 1
}