API 參考
VidioClient 是從 Python 與 VIDIO API 互動的主要入口點。使用它上傳文件、創建精華片段工作、檢查工作狀態、渲染輸出，並等待處理完成。
目前API存取僅對企業計劃可用。如果您不是企業用戶但有興趣使用該API，請在這裡申請存取 這裡。
用戶端模型
VidioClient 提供了一個簡單的介面來使用 VIDIO API。在使用您的 API 金鑰創建客戶端後，您可以上傳輸入文件、創建精華片段工作、輪詢工作狀態、渲染輸出以及等待工作完成。
屬性
api_keystring
您的 VIDIO API 金鑰，用於驗證請求。
方法
類別
VidioClient(api_key)初始化客戶端
創建一個新的 VidioClient 實例。
Parameters
api_keystring
您的 VIDIO API 金鑰。
Returns
一個配置好的 VidioClient 實例。
python
from vidio import VidioClient
import os
client = VidioClient(
api_key=os.getenv("VIDIO_API_KEY")
)方法
client.upload(file_path)上傳文件
上傳本地文件到 VIDIO 並返回包含輸入鍵的上傳結果。
Parameters
file_pathstring
您要上傳的文件的本地路徑。
Returns
包含 `input_key` 的上傳結果對象。
python
result = client.upload("/path/to/video.mp4")
print(result.input_key)方法
client.create_highlight_reel(input_keys, video_category, output_length, aspect_ratio)創建精華片段
從一個或多個上傳的輸入文件創建一個精華片段工作。
Parameters
input_keyslist[string]
由
upload() 返回的上傳文件鍵的列表。輸入鍵的順序決定了輸出視頻中媒體的順序。video_categorystring
視頻類別，如
ball-sports。可以是 podcast、ball-sports、non-ball-sports、beauty-product-demo、wedding、travel、others。為了獲得最佳效果，請指定最接近您內容的類別。如果您的內容不符合任何類別，請使用 others。output_lengthinteger
所需的輸出長度（以秒為單位）。輸出長度應小於或等於所有輸入視頻總長度。
aspect_ratiostring
輸出長寬比，如
landscape、portrait 或 square。Returns
一個包含 `job_id` 和狀態信息的工作對象。
python
job = client.create_highlight_reel(
input_keys=[result.input_key],
video_category="ball-sports",
output_length=30,
aspect_ratio="landscape",
)
print(job.job_id)
print(job.status)方法
client.get_job(job_id)獲取工作
獲取工作當前狀態。
Parameters
job_idstring
創建精華片段工作時返回的工作 ID。
Returns
一個具有最新狀態的工作對象。
python
job_status = client.get_job(job.job_id)
print(job_status.status)方法
client.wait_for_job(job_id)等待工作
輪詢 API 直到精華片段工作達到完成狀態。
Parameters
job_idstring
要等待的工作 ID。
Returns
最終完成的工作對象。
python
final_job = client.wait_for_job(job.job_id)
print(final_job.status)方法
client.render(job_id)渲染輸出
開始為已完成的精華片段工作渲染輸出視頻。
Parameters
job_idstring
已完成的精華片段工作 ID。
Returns
具有渲染狀態的渲染結果對象。
python
render_result = client.render(
job_id=job.job_id
)
print(render_result.status)方法
client.wait_for_render(job_id)等待渲染
輪詢直到渲染完成並且輸出準備好。
Parameters
job_idstring
與渲染相關的工作 ID。
Returns
最終渲染結果對象。
python
final_render = client.wait_for_render(job.job_id)
print(final_render.output_url)