GET/api/v1/assets
Llistar Multimèdia
Els teus arxius (vídeos, àudios, imatges, documents) amb el seu id, tipus i estat. Els punters de lliurament no venen aquí perquè caduquen: demana'ls d'un en un amb la fitxa de l'asset. El que sí porten les imatges, àudios i arxius ja llests és public_url, l'adreça estable sota el teu domini per usar-la tal qual a l'HTML del teu web.
Paràmetres de consulta
starting_afterinteger
Cursor: retorna arxius amb id més gran que aquest.
kindstring
Filtra per tipus d'arxiu.Valors: video · audio · image · file
curl "https://www.clonify.com/api/v1/assets" \
-H "Authorization: Bearer clk_live_…"
{
"object": "list",
"data": [{
"object": "asset",
"id": 42,
"kind": "image",
"title": "Portada del curso",
"file_name": "portada.webp",
"mime_type": "image/webp",
"file_size_bytes": 48210,
"duration_seconds": null,
"status": "ready",
"folder_id": null,
"public_url": "https://example.com/media/42",
"created_at": "2026-06-11T09:00:00.000Z",
"updated_at": "2026-06-11T09:00:00.000Z"
}],
"has_more": false,
"next_starting_after": null
}
POST/api/v1/assets
Pujar un arxiu a Multimèdia
Puja un arxiu al teu Multimèdia. Envia url (un enllaç) o file_base64 (els bytes), un dels dos. El VÍDEO només per url, sense límit de mida: el descarrega el nostre motor i queda en processing uns minuts fins que està llest. La resta queda disponible a l'instant, i les imatges s'optimitzen a WebP pel camí. Ocupa espai d'emmagatzematge del teu pla: sense espai, 403.
Permís d'escriptura
Cos (JSON)
urlstring (URL)
Enllaç http(s) accessible a l'arxiu. La via bona, i l'única per a vídeo.
file_base64string (base64)
Els bytes en base64, sense el prefix «data:». Només arxius petits (uns 3 MB): la resta, per url.
file_namestring ..255
Nom amb la seva extensió. Obligatori amb file_base64; amb url es dedueix de l'enllaç.
kindstring
Valors: video · audio · image · file
curl -X POST "https://www.clonify.com/api/v1/assets" \
-H "Authorization: Bearer clk_live_…" \
-H "Content-Type: application/json" \
-d '{"url":"…","file_base64":"…"}'
{
"object": "asset",
"id": 118,
"kind": "video",
"title": "Clase 1",
"file_name": "clase-1.mp4",
"status": "processing",
"public_url": null
}
GET/api/v1/assets/{id}
Llegir un asset de Multimèdia
La fitxa d'un arxiu del teu Multimedia i com entregar-lo: els vídeos porten embed_url (iframe signat, llest per incrustar) i la resta (imatge, àudio, arxiu) porten download_url. Utilitza-ho per resoldre les accions { type: "asset", asset_id } que retorna el xat, igual que resols els productes amb la seva fitxa. Només es serveixen assets ja processats. Un en procés retorna 404.
curl "https://www.clonify.com/api/v1/assets/1" \
-H "Authorization: Bearer clk_live_…"
{
"object": "asset",
"id": 42,
"kind": "file",
"title": "Plantilla de avatar de cliente",
"file_name": "plantilla-avatar.pdf",
"mime_type": "application/pdf",
"file_size_bytes": 183422,
"duration_seconds": null,
"embed_url": null,
"download_url": "https://www.clonify.com/api/v1/assets/42/download"
}
GET/api/v1/assets/{id}/download
Descarregar els bytes d'un asset
Els bytes del fitxer (imatge, àudio o document), amb la mateixa clau que la resta de l'API: NO és un enllaç públic per reenviar a un usuari final. El teu sistema descarrega el fitxer i el lliura de nou a la seva plataforma (adjunt de Discord, media de Telegram…). Admet la capçalera Range. Els vídeos no es descarreguen: s'incrusta amb l'embed_url de la fitxa.
curl "https://www.clonify.com/api/v1/assets/1/download" \
-H "Authorization: Bearer clk_live_…"