thumbnails:Array or Hash
API 版本：V2
上級：輸出
兼容的工作類型：VOD
例：
描述：
對於每個輸出，您可以要求一個或多個縮略圖。
每個輸出都可以有自己的縮略圖集，這些縮略圖集具有唯一性尺寸， base_url和訪問控制組。
通過在數組中傳遞多個縮略圖哈希，可以為單個輸出創建多組縮略圖。如果在數組中傳遞了縮略圖選項，則標籤必須設置為set。
套裝S3 訪問控制使用與用於輸出視頻相同的選項。
縮略圖每組限制為100個。如果根據請求的選項將生成更多縮略圖，則將在輸出中添加警告，並且在達到限制時將停止創建縮略圖。
注意：沒有像縮略圖一樣的工作。僅使用縮略圖指定輸出還將創建具有我們默認轉碼設置的可計費全長mp4，並將其上傳到臨時存儲中。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: [
{
“ label”：“第一”，
「數字」：+10
}，
{
“ label”：“第二”，
「互動框架」:+5000
}
]
}
]
}
也可以看看：標籤
label:String
API 版本：V2
兼容的工作類型：VOD
例：海報
描述：
縮略圖集的名稱。請求數組中的縮略圖集時必需。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: [
{
“ label”：“海報”
}，
{
“ label”：“片段”
}
]
}
]
}
format:String
API 版本：V2
默認： png
有效值： png或jpg
兼容的工作類型：VOD
例： jpg
描述：
縮略圖的格式。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“格式”：“ jpg”
}
}
]
}
number:Integer
API 版本：V2
有效值：正整數
兼容的工作類型：VOD
例：3
描述：
許多要捕獲的縮略圖。Zencoder將在文件的整個持續時間內抓取均勻分佈的縮略圖。因此，如果您要1張縮略圖，它將位於文件中間。在8分鐘的視頻上指定3個縮略圖會導致大約2、4和6分鐘的縮略圖。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「數字」：3
}
}
]
}
start_at_first_frame:Boolean
API 版本：V2
默認：假
有效值：對或錯
兼容的工作類型：VOD
例：真正
描述：
使用時數用於生成縮略圖的選項，它將開始從第一幀開始拍攝縮略圖。
例如，在使用時，如果您的視頻時長為5秒，而您使用數選項，這將在0、1、2、3和4處創建縮略圖。通常，它會以0.83s，1.66s，2.49s，3.32s和4.15s的速度抓取縮略圖。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「數字」：5
“ start_at_first_frame”：是
}
}
]
}
interval:Float
API 版本：V2
兼容的工作類型：VOD
例：+60
描述：
以均勻的間隔（以秒為單位）拍攝縮略圖。Zencoder將在文件的每N秒返回一個縮略圖。因此，如果您選擇間隔為60，並且輸入文件的長度為12分鐘，則您將獲得12張縮略圖，每分鐘縮略圖一次。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“間隔”：+60
}
}
]
}
也可以看看： interval_in_frames
interval_in_frames:Float
API 版本：V2
兼容的工作類型：VOD
例：120
描述：
以均勻的間隔以幀為單位拍攝縮略圖。Zencoder將在文件的每N幀中返回一個縮略圖。因此，如果您選擇間隔為120，並且您的輸入文件為每秒29.97幀，則大約每4秒您將獲得一次縮略圖。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「互動框架」:120
}
}
]
}
也可以看看：間隔
times:Array
API 版本：V2
兼容的工作類型：VOD
例： [0，30，60，90]
描述：
擷取縮圖的次數，以秒為單位。小數有效。因此，將時間設置為[12.5，25]會抓取兩個縮略圖，一個縮略圖在12.5秒，另一個縮略圖在25秒。該值必須是非負數的數組。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“次”：[0、30、60、90]
}
}
]
}
aspect_mode:String
API 版本：V2
默認：保留
有效值：保存，拉伸，裁剪或填充
兼容的工作類型：VOD
例：墊
描述：
創建縮略圖時要使用的外觀模式。
注意：由於視頻縮放算法的限制，縮略圖的尺寸將為偶數。例如，如果您請求100x75的縮略圖，則將獲得100x74的縮略圖。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“ aspect_mode”：“ pad”，
「寬度」：200，
「高度」：200
}
}
]
}
size:String
API 版本：V2
兼容的工作類型：VOD
例：400x300
描述：
縮略圖的目標分辨率，例如“ 160×120”。如果未提供尺寸，縮略圖將與輸出視頻的尺寸相同。默認情況下，我們將保留長寬比，因此，如果此大小參數的長寬比與影片的長寬比不匹配，則生成的文件可能與該大小不完全匹配。如果將相應的輸出文件的Stretch設置為true，則該縮略圖也將被拉伸以填充分辨率。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“尺寸”：“ 400x300”
}
}
]
}
也可以看看：寬度，高度和Aspect_mode
width:Integer
API 版本：V2
有效值：正整數
兼容的工作類型：VOD
例：640
描述：
縮略圖寬度。如果沒有提供寬度，我們將使用輸出文件的寬度，或縮放到尺寸要么高度設置。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「寬度」：640
}
}
]
}
也可以看看：尺寸，高度和Aspect_mode
height:Integer
API 版本：V2
有效值：正整數
兼容的工作類型：VOD
例：480
描述：
縮略圖高度。如果沒有提供高度，我們將使用輸出文件的高度，或縮放為尺寸要么寬度設置。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「高度」：480
}
}
]
}
也可以看看：尺寸，寬度和Aspect_mode
base_url:String
API 版本：V2
有效值：有效的S3，雲文件，GCS，FTP，FTPS或SFTP URL（減去文件名）。格式：s3：// [存儲桶名稱] / [路徑]或ftp：// [用戶]：[密碼] @ [ftp.url] / [路徑]
兼容的工作類型：VOD
例：
描述：
縮略圖的輸出目標。如果base_url為空白，則將縮略圖存儲在Zencoder S3存儲桶中。Zencoder S3存儲桶中存儲的文件將在24小時後可用。請注意，文件名在輸出之間不是唯一的（例如frame_0000.png），因此目標位置應該是唯一的目錄或鍵前綴，以避免覆蓋文件。
FTP用戶：我們會嘗試從服務器的根目錄進行寫入，因此請為您的URL使用絕對路徑，以確保我們可以成功寫入服務器。
憑證說明：
如果您通過base_url提供憑據，則這些憑據將出現在對工作細節，輸出細節等如果證書與Zencoder一起存儲，它們將不會出現在這些響應的url中。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“ base_url”：“ s3：// my-output-bucket /”
}
}
]
}
prefix:String
API 版本：V2
默認：幀
兼容的工作類型：VOD
例：
描述：
縮略圖文件將使用順序文件名導出。但是，您可以為縮略圖文件指定自定義前綴。如果未指定前綴，我們將使用框架。例如，如果使用前綴“ custom”，則導出的文件將命名為custom_0000.png，custom_0001.png等。如果沒有自定義前綴，它們將被命名為frame_0000.png，frame_0001.png等。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“ prefix”：“拇指”
}
}
]
}
filename:String
API 版本：V2
默認：幀
兼容的工作類型：VOD
例：
描述：
可以基於多個屬性為縮略圖文件指定文件名。屬性包括數字，填充數字，寬度，高度和尺寸。不需要添加文件擴展名，因為Zencoder將基於“格式”選項添加文件擴展名。
必須使用數字或填充數字，所有其他均為可選。填充編號使用4個點（0000、0001等）。
高度，寬度和大小將基於生成的縮略圖的實際大小。
例： _x-縮略圖
有效字符包括字母，數字，破折號，下劃線和內插值。
注意：如果指定文件名，則指定任何文件名字首將被忽略。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“文件名”：“ _ x-縮略圖”
}
}
]
}
public:Boolean
API 版本：V2
默認：假
有效值：對或錯
兼容的工作類型：VOD
描述：
與...相同上市用於輸出文件。看到上市有關此選項的完整文檔。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「數字」：10
“公開”：真實
}
}
]
}
也可以看看：訪問控制
access_control:Array
API 版本：V2
兼容的工作類型：VOD
描述：
與...相同訪問控制用於輸出文件。看到訪問控制有關此選項的完整文檔。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「訪問控制」：[
{
「權限」：“讀”，
“ grantee”：“ someone@example.com”
}
]
}
}
]
}
grantee:String
API 版本：V2
有效值：有效的S3受贈方（電子郵件，ID或URI）
兼容的工作類型：VOD
描述：
與...相同受贈人用於輸出文件。看到受贈人有關此選項的完整文檔。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「訪問控制」：[
{
「權限」：「完全控制」,
「獲撥款人」
}
]
}
}
]
}
permission:String
API 版本：V2
有效值：包含以下內容的字符串或字符串數組：READ，READ_ACP，WRITE_ACP或FULL_CONTROL
兼容的工作類型：VOD
描述：
與...相同允許用於輸出文件。看到允許有關此選項的完整文檔。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「訪問控制」：[
{
「權限」：「完全控制」,
「獲撥款人」
}
]
}
}
]
}
rrs:Boolean
API 版本：V2
默認：假
有效值：對或錯
兼容的工作類型：VOD
描述：
與...相同rrs用於輸出文件。看到rrs有關此選項的完整文檔。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“ rrs”：是
}
}
]
}
headers:Hash
API 版本：V2
兼容的工作類型：VOD
例： {“ Content-Type”：“二進制/八位字節流”}
描述：
HTTP 標頭， 以便在我們上傳縮圖時與縮圖一起傳送。當前在使用S3和雲文件時支持此功能。
Zencoder支持設置以下標頭的有限子集：緩存控制，內容處理，內容編碼，內容類型，過期，x-amz-acl，x-amz-存儲類，x-amz服務器端加密和x-amz-meta- * 。
未指定輸出位置時，標題將被忽略。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
“標題”：{
“ Content-Type”：“二進制/八位字節流”，
“ x-amz-acl”：“公共讀寫”
}
}
}
]
}
credentials:String
API 版本：V2
兼容的工作類型：VOD
例： ftp_dev_server
描述：
引用要用於傳輸的已保存憑據的暱稱，該別名在帳戶憑據部分。
注意：聯合服務的憑據僅用於輸出視頻。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「網址」：」ftp://ftp.example.com/thumbnails/「,
“憑據”：“ ftp_dev_server”
}
}
]
}
也可以看看： base_url
parallel_upload_limit:Integer
API 版本：V2
默認：S3為30，其他所有目的地為10。
有效值：介於 1 到 30 之間的整數
兼容的工作類型：VOD
例：5
描述：
上載縮略圖時最多可同時上傳的數量。
這可能會加快傳輸時間，具體取決於遠程服務器上的帶寬。請注意，更多的連線可能會造成伺服器負載較重。如果您在上傳超時方面遇到問題，或者想防止Zencoder在上傳文件時使用過多帶寬，請將其設置為1。
{
「輸入」：「S3：//zencodertesting/test.mov」，
「輸出」：[
{
「縮圖」: {
「網址」：」ftp://ftp.example.com/thumbnails/「,
“ parallel_upload_limit”：5
}
}
]
}