Import a song
POST
/v1/songs
const url = 'https://api.clipbeat.app/v1/songs';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"url":"https://example.com","rights_attestation":true,"rights_version":"2026-11-21"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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).
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”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
Responses
Section titled “Responses”Already imported
Media typeapplication/json
object
id
string format: uuid
title
string | null
duration_sec
number | null
status
string
lyrics_status
string
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
lyrics_status
string
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}