Sorenson Media - Video Encoding Leaders Since 1998

1. Purchase a Squeeze Managed Plan, or Get a Free Trial.

When you select a monthly plan and purchase, we’ll provide you with a Server Instance, API documentation, and your Account Information.

2. Get your Authentication Credentials

It’s time to establish a session with Squeeze Managed Server. Use the CURL command below to post your username and password to the server. The server will respond with a block of JSON containing your account ID, session ID, and an encrypted token. These credentials will be used in your subsequent requests to Squeeze Managed Server.

                # curl -i -X post -d "username=<username>" -d "password=<password>" http://360services.sorensonmedia.com/sessions

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 18 May 2011 20:54:57 GMT
Status: 200

{ 
	"session_id" : "495e04ea-5dd7-4e50", 
	"account_id" : "6cf5da01-c433-417d", 
	"token" : "92d94c39-8e8a-434e"
} 
}
            

Required Parameters: username, password

3. Setup a Publishing Destination

Squeeze Server can deliver your transcoded videos to several destinations including Amazon S3, Akamai, Limelight, and generic FTP servers. The examples below show two CURL commands; the first establishes a FTP destination and the second a S3 destination. The server will respond with a block of JSON containing a unique ID for your new publishing destination, which you can use later when you initiate a transcoding job.

                
# curl -i -X post -u <account_id>:<token> -d "service=ftp" -d "service_uri=<ftp_server_address>" 
-d "username=<ftp_username>" -d "password=<ftp_password>" -d "name=<user_defined_destination_name>" 
http://360services.sorensonmedia.com/accounts/<account_id>/publishing_destinations

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 18 May 2011 20:54:57 GMT
Status: 200

{
	"id" : "c8dabc26-7d8d-11e0-9481-123138018492",
	"service" : "ftp",
	"service_uri" : "<ftp_server_address>",
	"username" : "<ftp_username>",
	"name" : "<user_defined_destination_name>"
}


# curl -i -X post -u <account_id>: -d "service=s3" -d "username=<s3_account_key>" 
-d "password=<s3_account_secret_key>" -d "name=<user_defined_destination_name>" 
http://360services.sorensonmedia.com/accounts/<account_id>/publishing_destinations

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 18 May 2011 20:54:57 GMT
Status: 200

{
	"id": "c8dabc26-7d8d-11e0-9481-123138018491",
	"service": "s3",
	"username": "<s3_account_key>",
	"name": "<user_defined_destination_name>"
}

                
            

4. Identify a Source Asset

Squeeze Server can ingest your source assets from several origins including Amazon S3, HTTP locations, and FTP servers. The following CURL examples illustrate how to tell Squeeze Server to retrieve your assets from FTP and S3. The server will respond with a block of JSON that includes an ID for your source asset, which you will use later when you initiate a transcoding job.

                
# curl -i -X post -u <account_id>:<token> -d "source_file_name=<file_name>" -
d "display_name=<video_title>" -d "description=<video_description>" -d "author_name=<full_name>" 
-d "source_uri=<ftp://ftp_username:ftp_password@ftp.ftpdomain.com/path/to/file/>" 
-d "source_uri_username=<ftp_username>" -d "source_uri_password=<ftp_password>" 
http://360services.sorensonmedia.com/assets

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 18 May 2011 20:54:57 GMT
Status: 200

{
	"asset_id": "2b985bfa42605s4bba", 
	"status": "success" 
}

# curl -i -X post -u <account_id>:<token> -d "source_file_name=<file_name>" 
-d "display_name=<video_title>" -d "description=<video_description>" 
-d "author_name=<full_name>" -d "source_s3_bucket=<s3_bucket>" 
-d "source_s3_key=<s3_key>" -d "source_s3_username=<3_user>" 
-d "source_s3_password=<s3_pwd>" http://360services.sorensonmedia.com/assets

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 18 May 2011 20:54:57 GMT
Status: 200

{
	"asset_id": "2b985bfa42605s4bba", 
	"status": "success" 
}             
                
            

5. Create a Transcode Job

After identifying your source asset and delivery destination you’re ready to instruct Squeeze Managed Server to begin your transcode job. Using the CURL command below, post your source asset_id from Step #4 and your publishing_destination_id from Step #3 to the server. You can also include a callback URL as show below. The server will respond with a block of JSON containing a transcode_job_id which you can use to monitor the status of your transcode job.

                
# curl -i -X post -u <account_id>:<token> -d "publishing_destination_id=<dest_id>" 
-d "publishing_destination_directory=<dest_dir>" -d "output_asset_display_name=<video_title>" 
-d "output_asset_description=<video_description>" -d "output_asset_author_name=<full_name>" 
-d "callback_url=<callback_url>" -d "preset_name=MPEG4-AVC-720p" 
http://360services.sorensonmedia.com/transcode_jobs/<asset_id>

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 18 May 2011 20:54:57 GMT
Status: 200

{
	"transcode_job_id":"3b628d40-c282-11df-ad3e-12313804e273", 
	"output_asset_id":"805d5ec7Xd840g4b851ac29p0e2d6759f6fe", 
	"status":"success"
}
                
            

6. Get Transcode Job Status

Squeeze Managed Server allows you to request status information for transcode jobs that you have previously initiated. To query the server for job status, use the CURL command below and the transcode_job_id from Step #5. The server will respond with a block of JSON containing the current phase of the transcoding job and its state of completion

                
# curl -i -X get -u <account_id>:<token> 
http://360services.sorensonmedia.com/transcode_jobs/<transcode_job_id>

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 18 May 2011 20:54:57 GMT
Status: 200

{
	"time_submitted": "2011-05-18 17:31:59", 
	"time_started": "2011-05-18 17:32:07", 
	"time_finished": "2011-05-18 17:33:32", 
	"transcode_job_status": 100, 
	"percent_compete": 100.0, 
	"transcode_job_status_description": "Published", 
	"source_asset_id": "2b985bfa42605s4bba", 
	"status": "success"
}
                
            

Required Parameters: account_id, token, transcode_job_id

7. Get Output Asset

If you did not specify a publishing destination in Step #5 you can use the following CURL command to retrieve your output asset download URL. Squeeze Managed Server will also provide a list of embed codes and a permalink location that you may use if you choose to store your assets on the Sorenson 360 video hosting platform.

                
# curl -i -X get -u <account_id>:<token> -d "embed_template=2" 
http://360services.sorensonmedia.com/assets/<asset_id>

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 18 May 2011 20:54:57 GMT
Status: 200

{
	"direct_asset_url" : <omitted for brevity>, 
	"thumbnail_image_url" : <omitted for brevity>, 
	"permalink_location" : <omitted for brevity>, 
	"embed_list' : {
		"1280x720 - Widescreen" : <omitted for brevity>, 
		"640x360 - Widescreen" : <omitted for brevity>,
	},
	"file_size" : 187905”
}
                
            

Required Parameters: account_id, token, embed_template, asset_id

8. Additional Resources

For advanced API documentation, including methods for integrating Squeeze Managed Server into your website, go to our developer’s forum. Want to check out even more encoding presets created by our staff and the Squeeze 8 community? Go to our Preset Exchange.