登记 / 查询视频素材

将公网可访问的图片或视频登记为平台素材，获得 vidast_… ID。在 创建视频生成任务 的首尾帧、参考图/参考视频等字段中，可用 asset://vidast_… 引用该素材。

适用于支持素材库的视频模型（例如 Seedance seedance-2.0-os、seedance-2.0-overseas-hc-os 等）。模型 ID 见 获取模型（modality=video）或 模型广场。

---

Endpoint

Method	URL	说明
POST	{TRINITY_BASE_URL}/video/assets	登记素材
GET	{TRINITY_BASE_URL}/video/assets/{assetId}	查询素材

成功时 HTTP 状态码为 200。跨工作区或不存在的 assetId 返回 404。

---

Base URL

项	值
Base URL	https://api.trinitydesk.ai/v1
协议	HTTPS

export TRINITY_BASE_URL="https://api.trinitydesk.ai/v1"
export TRINITY_API_KEY="xh-..."

---

Headers

Header	必填	说明
Authorization	是	Bearer <TRINITY_API_KEY>
Content-Type	登记时	application/json

---

请求示例

登记素材

curl -sS "${TRINITY_BASE_URL}/video/assets" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TRINITY_API_KEY}" \
  -d '{
    "url": "https://example.com/ref.jpg",
    "asset_type": "Image",
    "model": "seedance-2.0-os"
  }'

查询素材

curl -sS "${TRINITY_BASE_URL}/video/assets/vidast_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer ${TRINITY_API_KEY}"

---

请求体字段（登记）

字段	类型	必填	说明
url	string	是	公网 HTTPS 图片或视频地址
asset_type	string	是	Image 或 Video
model	string	建议	视频模型 ID；用于选择国内 / 海外素材通道。省略时按 channel 使用平台默认模型
channel	string	否	domestic 或 overseas。省略时由 model 推断

GET 路径参数 assetId 为登记响应中的 id（形如 vidast_…）。

---

返回字段

字段	类型	说明
id	string	平台素材 ID，形如 vidast_…；生视频中引用为 asset:// + 该值
object	string	固定 video.asset
status	string	如 processing、completed、failed
asset_type	string	Image 或 Video
channel	string	domestic 或 overseas
model	string	登记时使用的模型 ID（若有）
upstream_asset_id	string	素材侧标识
created_at	string	创建时间（ISO-8601）

---

返回示例

登记 / 查询成功

{
  "id": "vidast_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video.asset",
  "status": "completed",
  "asset_type": "Image",
  "channel": "domestic",
  "model": "seedance-2.0-os",
  "upstream_asset_id": "asset-xxxxxxxx",
  "created_at": "2026-08-13T06:00:00Z"
}

素材不存在

{
  "error": {
    "type": "invalid_request_error",
    "code": "asset_not_found",
    "message": "Asset not found"
  }
}

---

在生视频中引用

登记成功后，在 POST /video/generations 的 frame_images[].image_url.url、input_references[].image_url.url 或 input_references[].video_url 等字段中传入：

asset://vidast_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

完整创建与轮询见 创建视频生成任务；字段细节见 视频生成 · 高级参数。

---

Python 示例

import os
import requests

base = os.environ["TRINITY_BASE_URL"]
headers = {
    "Authorization": f"Bearer {os.environ['TRINITY_API_KEY']}",
    "Content-Type": "application/json",
}

# 登记
r = requests.post(
    f"{base}/video/assets",
    headers=headers,
    json={
        "url": "https://example.com/ref.jpg",
        "asset_type": "Image",
        "model": "seedance-2.0-os",
    },
    timeout=120,
)
r.raise_for_status()
asset = r.json()
asset_id = asset["id"]
print(asset_id, asset["status"])

# 查询
q = requests.get(
    f"{base}/video/assets/{asset_id}",
    headers={"Authorization": headers["Authorization"]},
    timeout=60,
)
q.raise_for_status()
print(q.json())

# 生视频中引用（节选）
# "image_url": { "url": f"asset://{asset_id}" }

---

相关

• 创建视频生成任务
• 视频生成 · 高级参数
• 获取模型
• 错误与调试