快速入門:Zencoder

Zencoder 的核心是它的編碼服務。將您的視頻點播 (VOD) 內容作為輸入,Zencoder 對其進行編碼,生成具有您指定的格式和其他設置的輸出,並將它們傳送到您選擇的目的地。在本簡介中,您將學習如何提交基本工作。

Zencoder API

所有操作均使用 Zencoder API 執行。雖然有一個 Request Builder 可用於嘗試一些基本的 API 請求,但您可能很快就會轉向直接訪問 API。在本指南中,您可以修改和使用如下所示的 cURL 命令,或 REST API 客戶端,例如 Postman

如果您不熟悉 cURL,請參閱 設置 cURL

發出請求

提交工作的請求是傳送至下列地點的POST要求:

https://app.zencoder.com/api/v2/jobs

必要的標頭

有兩個標頭必須隨請求一起發送:

  • Zencoder-Api-Key: YOUR_API_KEY
  • Content-Type: application/json

您可以通過訪問 https://app.zencoder.com/api獲取您的 API 密鑰。對於本練習,您可以使用完全訪問或僅集成密鑰。

更多信息

該請求可能(通常會)包括作業的輸出設置,包括輸出目的地、通知設置和轉碼設置。在這個簡單的練習中,我們將跳過它,但您可以在 編碼設置中找到更多信息。

我們目前支持使用 HTTP/HTTPS、S3、雲文件、FTP/FTPS、SFTP 和 Aspera下載文件。

一個簡單的新工作請求只需要在正文中指定輸入文件的 URL,加上您的帳戶API密鑰在一個名為Zencoder-Api-Key .

  {
  "input": "s3://zencodertesting/test.mov"
  }

您可以使用以下 cURL 命令對此進行測試。

  curl --header "Zencoder-Api-Key: YOUR_API_KEY" \
       --header "Content-Type: application/json" \
       --data '{"input":"s3://zencodertesting/test.mov"}' \
       https://app.zencoder.com/api/v2/jobs
  

將此代碼複製到文本編輯器並將 YOUR_API_KEY 替換為您的 API 密鑰。然後打開命令提示符,在命令提示符處複製並粘貼 cURL 命令,然後按 Return (Enter)。

Windows 用戶注意事項:由於 Windows 上 cURL 的限制,您需要像雙引號一樣轉義\"並將--data內容包裝在雙引號而不是單引號中。

此請求將為該帳戶創建一個編碼作業,並嘗試將位於 s3://zencodertesting/test.mov 的文件下載並轉碼到默認輸出目標。

響應

當您通過 API 創建新的編碼作業時,我們的服務器將立即響應有關正在創建的作業和輸出文件的詳細信息。您應該存儲作業和輸出 ID,以便在編碼過程中跟踪它們。請注意,這id是 64 位元範圍內的整數。

數據將以 JSON 格式返回。

上一個新的編碼工作範例會傳回下列內容,並包含201 Created狀態碼。

  {
    "id": 366118847,
    "outputs": [
      {
        "id": 1297606670,
        "label": null,
        "url": "https://zencoder-temp-storage-us-east-1.s3.amazonaws.com/o/20170422/69a1a537e5b40f91c172e6b033827159/9ea8d51bc1a71545eb9c700c0379e950.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAI456JQ76GBU7FECA%2F20170422%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170422T214927Z&X-Amz-Expires=86399&X-Amz-SignedHeaders=host&X-Amz-Signature=9c0b05565dabcd5d7405a882956ef2babff6173c80cbafa36b2bd12df569e594"
      }
    ]
  }

注意:作業可能仍會失敗,因為 輸入文件不存在輸出位置無效,文件本身是 ,或者 其他原因