查詢資產下載資訊

從原始碼生成 GET /assets/{asset_id} 的鑑權、欄位、響應、錯誤與安全呼叫參考。

公開測試API v1 · 1.4.0最後核實 2026-09-15

本頁目錄

操作

GET /assets/{asset_id}

operationId: get_asset_v1_assets__asset_id__get

讀取所屬資產並返回新的短期簽名下載 URL。持久儲存資產 ID，而不是過期連結。實際下載及儲存跳轉均不應攜帶 API 憑據，仍受歸屬和保留策略限制。

鑑權與副作用

使用可信環境中的 Bearer API Key。所需權限：animations:read

此操作不啟動付費生成，其他狀態變化見上文說明。

引數

引數	位置	型別	必填	約束 / 預設值	含義
`asset_id`	`path`	`string`	是	`format`: `uuid`	所屬公共資源 UUID；任務、資產、檔案 ID 不能互換。

響應

HTTP	正文	含義
`200`	AssetResponse	成功的公開響應，示例數值僅用於說明。
`400`	APIErrorEnvelope	輸入錯誤，修正請求後再嘗試。
`401`	APIErrorEnvelope	API Key 缺失、到期或被撤銷。
`403`	APIErrorEnvelope	帳戶資格、帳戶狀態或 Key 權限不允許此操作。
`404`	APIErrorEnvelope	資源不可用、不屬於當前使用者，或簽名無效/過期。
`429`	APIErrorEnvelope	觸發帳戶級速率或佇列限制，遵循 Retry-After 等待。
`500`	APIErrorEnvelope	內部錯誤，保留任務 ID 和冪等鍵，僅標記可重試時重試。
`503`	APIErrorEnvelope	服務或供應商不可用，僅 error.retryable 為 true 時重試。

響應頭

HTTP	響應頭	型別	含義
`429`	`Retry-After`	`integer`	建議等待秒數，遵循服務值並設定總體截止時間。
`503`	`Retry-After`	`integer`	建議等待秒數，遵循服務值並設定總體截止時間。

響應示例

json

{
  "byte_size": 1024,
  "created_at": "2026-08-30T00:00:00Z",
  "download_expires_at": "2026-08-30T01:00:00Z",
  "download_url": "https://downloads.example.invalid/illustrative-asset",
  "format": "clip_video",
  "id": "00000000-0000-4000-8000-000000000003",
  "media": {
    "duration_seconds": 5.04,
    "fps": 25,
    "frame_count": 126,
    "height": 512,
    "width": 512
  },
  "mime_type": "video/mp4",
  "object": "asset"
}

這篇文件有幫助嗎？

允許文件互動分析

不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。隱私權政策

需要協助？聯絡支援

搜尋文件

查詢資產下載資訊

操作

鑑權與副作用

引數

響應

響應頭

響應示例

相關教程

這篇文件有幫助嗎？