抖音视频真实地址回填

douyin-video-url-backfill 用于外部应用在拿到抖音 videoId 和真实 videoUrl 后，把 videoUrl 同步回写到当前应用生成的抖音 Top10 资产 JSON 中。

能力信息

本能力只处理当前 API Key 绑定应用在当前组织下生成的抖音 Top10 资产。即使不同应用存在相同 videoId，也不会跨应用或跨组织回写。能力不会占用 douyin-top10 共享远端队列，也不会调用 session-hub。

回填视频地址

POST /api/open/v1/organizations/{orgId}/capabilities/douyin-video-url-backfill:execute
Authorization: Bearer <sk-organization-application-api-key>
Content-Type: application/json

{
  "applicationId": "organization-application-id",
  "input": {
    "videoId": "6652151927222193415",
    "videoUrl": "https://www.douyin.com/aweme/v1/play/?video_id=example"
  }
}

业务输入必须包含 input.videoId 和 input.videoUrl。applicationId 可省略；省略时平台会使用 API Key 绑定的应用作为回写主体。传入 applicationId 时必须与 API Key 绑定应用一致。

Agent CLI 映射

Agent CLI 目录中，backfill_douyin_video_url 会映射到本开放能力 douyin-video-url-backfill。CLI 指令用于 Agent / 数字员工大脑选择和补参数，不改变外部应用的开放 API 契约。

CLI 指令不是外部应用的 capabilityKey；外部应用仍调用本页的 douyin-video-url-backfill:execute。完整指令目录见 CLI 目录。

成功时返回本次查找和回写结果：

{
  "capabilityKey": "douyin-video-url-backfill",
  "message": "SUCCEEDED",
  "code": 200,
  "data": {
    "videoId": "6652151927222193415",
    "videoUrl": "https://www.douyin.com/aweme/v1/play/?video_id=example",
    "matchedArtifactCount": 1,
    "updatedArtifactCount": 1,
    "matchedVideoCount": 1,
    "artifacts": [
      {
        "artifactId": "artifact-id",
        "matchedVideoCount": 1,
        "updatedVideoCount": 1
      }
    ]
  }
}

如果请求传入了 videoUrl，但当前应用没有任何包含该 videoId 的抖音 Top10 资产，请求仍返回 200，并且 matchedArtifactCount、updatedArtifactCount、matchedVideoCount 都为 0。

回写范围

本能力只会读取和更新满足以下条件的资产：

• 资产归属当前请求的 orgId。
• 资产归属当前 API Key 绑定应用。
• 资产内容是抖音 Top10 JSON，且包含 douyin_top_videos[]。
• 视频条目的 video_id 与请求的 videoId 完全一致。

回写只修改匹配视频条目的 video_url 字段，不修改 video_id、original_video_url、标题、达人信息或其他统计字段。

常见错误