Sources

Create a new source

Create a new source from a media URL. The source will be analyzed to extract metadata and generate a thumbnail. The source will be automatically deleted after the data retention period.

POST

/api/sources

Authorization

header

string

required

Enter the project access token with the Bearer prefix, e.g. "Bearer project_access_token"

Bodyapplication/json

Source creation parameters

url

string

http-url

required

Url is the URL of the source, which must be a valid HTTP URL.

Examples:

https://example.com/video.mp4

metadata

object

Metadata allows for additional information to be attached to the source, with a maximum size of 2048 bytes.

Examples:

map[key:value key2:value2]

storage

object

Storage input configuration. Provide this or url, never both.

Responses

application/json

data

object

required

Data contains the response object

status

"success"

string

required

Status indicates the response status "success"

Created

application/json

error

object

required

status

"error"

string

required

Status indicates the response status "error"

Invalid request parameters

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Authentication error: invalid token or subscription inactive

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Unauthorized to perform this action: insufficient funds

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Rate limit exceeded

import Chunkify from '@chunkify/chunkify'; const client = new Chunkify({ projectAccessToken: 'My Project Access Token', }); const source = await client.sources.create({ url: 'https://example.com/video.mp4' }); console.log(source);

<?php use Chunkify\Client; $client = new Client( projectAccessToken: 'My Project Access Token', ); $source = $client->sources->create( url: 'https://example.com/video.mp4', ); var_dump($source);

package main import ( "context" "fmt" "github.com/chunkifydev/chunkify-go" "github.com/chunkifydev/chunkify-go/option" ) func main() { client := chunkify.NewClient( option.WithProjectAccessToken("My Project Access Token"), ) source, err := client.Sources.New(context.TODO(), chunkify.SourceNewParams{ URL: "https://example.com/video.mp4", }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", source) }

{ "data": { "audio_bitrate": 128000, "audio_codec": "aac", "created_at": "2025-01-01T12:00:00Z", "device": "iPhone", "duration": 120, "height": 1080, "id": "src_2G6MJiNz71bHQGNzGwKx5cJwPFS", "metadata": { "key1": "value1", "key2": "value2" }, "size": 1234567, "video_bitrate": 20000000, "video_codec": "h264", "video_framerate": 29.97, "width": 1920 }, "status": "success" }