Managed API - Create Transcode Job

Last Updated: Dec 16, 2014 03:18PM PST
Use this method to transcode an asset from one format to another.

Method: POST

Path: /transcode_jobs/:source_asset_id

Host: http://360services.sorensonmedia.com

Date: date

Authorization: <account_id>:<token>

Header Values:
  • source_asset_id: The unique identifier of your source video file; this value is returned by the Create Asset action

Required Parameters:
The following are required parameters:
  • preset_uri: URI to a valid Squeeze Server preset file (.spfx)
  • output_asset_display_name: The title to assign to the output asset
  • output_asset_description: A description to assign to the output asset
  • output_asset_author_name: The name of the person to whom attribution should be given for the output asset

Optional Parameters:
The following are optional parameters:
  • preset_id: Unique identifier of one of your Squeeze Server presets; can be used in place of preset_uri
  • preset_name: Human-readable name of one of your Squeeze Server presets; not unique, can be used in place of preset_uri. Your Squeeze Server account automatically includes the following default presets:
    • FLV-VP6-360p: Flash 8, VP6/MP3, 360p (.flv)
    • FLV-VP6-720p: Flash 8, VP6/MP3, 720p (.flv)
    • MPEG-TS-1080i25: Transport Stream, 1080i25 (.ts)
    • MPEG-TS-1080p24: Transport Stream, 1080p24 (.ts)
    • MPEG-TS-1080p25: Transport Stream, 1080p25 (.ts)
    • MPEG-TS-1080p29.97: Transport Stream, 1080p29.97 (.ts)
    • MPEG-TS-720p24: Transport Stream, 720p24 (.ts)
    • MPEG-TS-720p25: Transport Stream, 720p25 (.ts)
    • MPEG-TS-720p29.97: Transport Stream, 720p29.97 (.ts)
    • MPEG4-AVC-360p: MP4, H.264/AAC, 360p (.mp4)
    • MPEG4-AVC-720p: MP4, H.264/AAC, 720p (.mp4)
    • QT-H264-360p: QuickTime, H.264/AAC, 360p (.mov)
    • QT-H264-720p: QuickTime, H.264/ AAC, 720p (.mov)
    • WEBM-VP8-360p: WebM, VP8/Ogg, 360p (.webm)
    • WEBM-VP8-720p: WebM, VP8/Ogg, 720p (.webm)
    • WMV-VC1-360p: Windows Media, VC1/WMA, 360p (.wmv)
    • WMV-VC1-720p: Windows Media, VC1/WMA, 720p (.wmv)
  • callback_url : The URL of a web service for Squeeze Server to call when your transcoding job completes. Squeeze Server will send a POST request with the following parameters to your callback URL:
    • transcode_job_id
    • transcode_job_status
    • transcode_job_status_description
    • output_asset_id
    • callback_data
  • callback_data: User-defined text string to be included as a parameter to the callback URL; use only in conjunction with callback_url
  • publishing_destination_id: Unique identifier of one of your Squeeze Server publishing destinations, alternative to publishing_destination_name; note that all transcoding jobs automatically publish to your Squeeze Stream account if an alternate publishing destination is not specified
  • publishing_destination_name: Human-readable name of one of your Squeeze Server publishing destinations, alternative to publishing_destination_id; note that all transcoding jobs automatically publish to your Squeeze Stream account if an alternate publishing destination is not specified
  • publishing_destination_directory: The directory on your publishing destination server for Squeeze Server to publish your output file; required if publishing_destination_id or publishing_destination_name is used and publishing destination is an FTP or SFTP server
  • publishing_destination_file_name: The name of the output file that Squeeze Server will create on your publishing destination server; recommended if publishing_destination_id or publishing_destination_name is used and publishing destination is an FTP or SFTP server. Not available with S3 publishing locations.
  • publishing_destination_s3_bucket: (required if your publishing destination is Amazon S3) The name of your S3 bucket for Squeeze Server to publish your output file
  • publishing_destination_s3_key: (required if your publishing destination is Amazon S3) The S3 key for Squeeze Server to use when publishing your output file
  • queue_id: Unique identifier of one of your Squeeze Server transcoding queues, alternative to queue_name; transcoding job will go into your default queue if no other queue is specified
  • queue_name: Human-readable name of one of your Squeeze Server transcoding queues, alternative to queue_id; transcoding job will go into your default queue if no other queue is specified
  • notification_email_list: An array of email addresses to be notified when the transcode job is complete

Response:
The following values will be returned by the server:
  • output_asset_id: The unique identifier for the asset that will be created by the transcode job
  • transcode_job_id: Unique identifier for your transcoding job
  • status: Result of the request, will be set to either "success" or "failure"
  • message: A text field describing the error, if any

CURL Request Format:
curl -s http://360services.sorensonmedia.com/transcode_jobs/<source_asset_id> -X post -u <account_id>:<token> -d 'preset_name=<preset_name>' -d 'output_asset_display_name=<video_title>' -d 'output_asset_description=<video_desc>' -d 'output_asset_author_name=<author>' -d 'notification_email_list[]=<email_address>'

Sample JSON Response:
{
"transcode_job_id":"3b628d40-c282-11df-ad3e-12313804e273",
"output_asset_id":"805d5ec7Xd840g4b851ac29p0e2d675 9f6fe",
"status":"success",
"message":"TranscodeJobsuccessfullycreated"
}
squeezesupport@sorensonmedia.com
http://assets3.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete