Uploading a new asset

Request

Upload an asset video file directly to Panjaya Dubbing Studio.

This endpoint allows you to upload a video file directly, saving the need to upload to an external storage service. It accepts the same parameters as the Create Asset endpoint, except for the media_url parameter, which is replaced by the video file input.

Note that this endpoint is structured as a multipart/form-data request, where the request form field contains a JSON-serialized object with the asset parameters, and the video form field contains the video file to be uploaded.

You may additionally provide a background file to upload a clean background audio track. Refer to Background Audio section under create asset endpoint.

Security

api_key

Bodymultipart/form-datarequired

requestobjectrequired

A JSON object that accepts the same configuration as creating an asset (except for the media_url field).

Example:

{
  "languages": [
    { … }
  ],
  "locale": "en-US",
  "name": "My Asset"
}

videostringrequired

Video file to upload. Maximum size is 5GB.

backgroundstring or null

Any of:

Optional background audio file to upload. Maximum size is 500MB.

string (binary)

speechstring or null

Any of:

Optional speech audio file to upload. Maximum size is 500MB.

string (binary)

{
  "request": {
    "languages": [
      {
        "locale": "es-ES"
      }
    ],
    "locale": "en-US",
    "name": "My Asset"
  },
  "video": "string"
}

Responses

Asset was created successfully

Bodyapplication/json

asset_idstringrequired

namestringrequired

localestring, [ 5 .. 6 ] characters^[a-z]{2,3}-[A-Z]{2}$required

A locale code of a supported locale. If the locale is not supported, an error response of status 400 will be returned.

created_atstring, (date-time)required

statusstringrequired

Enum:"Dubbing""PendingReview""Ready""Failed"

durationnumber or nullrequired

Any of:

Duration of the source video in seconds. The field may be null while the asset is processing.

>= 0

number

errorApiAssetErrorInfo (object) or null

Any of:

In case of an error while processing the asset, the asset status will be Failed, and this field contains helpful information for identifying the issue.

source_video_urlstring or null

Any of:

The uploaded video before dubbing

[ 1 .. 2083 ] characters

string (uri)

thumbnail_urlstring or null

Any of:

A poster/thumbnail image for the asset, suitable for link previews. May be null while the asset is processing.

[ 1 .. 2083 ] characters

string (uri)

languagesArray of objectsrequired

Response

{
  "asset_id": "7b9b9e3c3c7e322aec4c3d9b",
  "name": "My Asset",
  "locale": "en-US",
  "created_at": "2021-08-10T12:00:00Z",
  "status": "Dubbing",
  "languages": [
    { … }
  ]
}