快手达人信息批量

kuaishou-creator-info-batch 用于按 JSON 数组批量创建快手达人信息采集任务。批量父任务会占用共享队列，内部 item 串行调用 session-hub。

能力信息

字段	值
能力 Key	`kuaishou-creator-info-batch`
能力名称	快手达人信息批量
能力类型	`workflow_execute`
共享队列	`douyin-top10`

当前快手和抖音 Top10 共用远端资源，所以本能力暂时共享 douyin-top10 队列。后续拆独立队列时，平台会切到预留的 kuaishou-creator-info 队列口径。

开始任务


POST /api/open/v1/organizations/{orgId}/capabilities/kuaishou-creator-info-batch:execute
Authorization: Bearer <sk-organization-application-api-key>
Content-Type: application/json


{
  "applicationId": "organization-application-id",
  "input": {
    "items": [
      {
        "kuaishouId": "lidaliang666"
      },
      {
        "kuaishouId": "ks_123456"
      }
    ]
  }
}

字段	必填	说明
`applicationId`	否	调用方团队应用 ID。传入时必须和 API Key 绑定的应用一致；不传时平台会使用 API Key 绑定的应用。
`input.items`	是	批量任务列表，至少 1 条，最多 100 条。
`input.items[].kuaishouId`	是	快手号。底层提示词为 `获取快手号%s的前十条作品的信息`。
`input.items[].externalItemId`	否	调用方系统内的行 ID 或幂等辅助标识，用于结果回看；不需要对账时可不传。


{
  "capabilityKey": "kuaishou-creator-info-batch",
  "message": "SUCCEEDED",
  "code": 200,
  "data": {
    "taskId": "platform-task-id",
    "batchId": "batch-id",
    "status": "RUNNING",
    "totalCount": 2,
    "succeededCount": 0,
    "failedCount": 0,
    "pendingCount": 2,
    "items": [
      {
        "itemIndex": 1,
        "externalItemId": null,
        "status": "RUNNING",
        "ossUrl": null,
        "artifact": null,
        "errorCode": null,
        "errorMessage": null,
        "startedAt": null,
        "finishedAt": null
      }
    ],
    "createdAt": "2026-05-21T09:00:00Z",
    "updatedAt": "2026-05-21T09:00:01Z"
  }
}

Agent CLI 映射

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

CLI 指令不是外部应用的 capabilityKey；外部应用仍调用本页的 kuaishou-creator-info-batch:execute。完整指令目录见 CLI 目录。

查询当前运行任务

快手达人信息能力与抖音 Top10 能力当前共享底层 douyin-top10 远端资源队列。批量任务本身会串行执行内部 item，并作为父任务占用一个 slot；内部 item 不单独抢占队列。队列容量由平台配置决定，所有 slot 都被占满时，新的快手达人信息或 Top10 创建请求会返回 409。


GET /api/open/v1/organizations/{orgId}/capabilities/kuaishou-creator-info-batch/current-task
Authorization: Bearer <sk-organization-application-api-key>


{
  "capabilityKey": "kuaishou-creator-info-batch",
  "message": "SUCCEEDED",
  "code": 200,
  "data": {
    "running": true,
    "queueKey": "douyin-top10",
    "ownerCapabilityKey": "kuaishou-creator-info-single",
    "taskId": "platform-task-id",
    "executionId": "platform-execution-id",
    "status": "RUNNING",
    "acquiredAt": "2026-05-21T09:00:00Z",
    "activeCount": 2,
    "capacity": 2,
    "owners": [
      {
        "slotIndex": 0,
        "ownerCapabilityKey": "kuaishou-creator-info-single",
        "taskId": "platform-task-id",
        "executionId": "platform-execution-id",
        "status": "RUNNING",
        "acquiredAt": "2026-05-21T09:00:00Z"
      },
      {
        "slotIndex": 1,
        "ownerCapabilityKey": "douyin-top10-single",
        "taskId": "platform-task-id-2",
        "executionId": "platform-execution-id-2",
        "status": "RUNNING",
        "acquiredAt": "2026-05-21T09:01:00Z"
      }
    ]
  }
}

顶层 ownerCapabilityKey/taskId/executionId/status/acquiredAt 保留为兼容字段，指向 owners[0]。新接入方应优先读取 activeCount、capacity 和 owners，用于判断共享队列当前占用情况。

所有 slot 都被占满时，新的快手达人信息或抖音 Top10 创建请求会返回 409。如果 ownerCapabilityKey 是其他能力，调用方应使用返回的 ownerCapabilityKey 与 taskId 查询对应任务。

查询任务


GET /api/open/v1/organizations/{orgId}/capabilities/kuaishou-creator-info-batch/tasks/{taskId}
Authorization: Bearer <sk-organization-application-api-key>

成功 item 的 artifact 字段是整份快手结果 JSON。平台不会把快手作品拆成子条目，所以不会返回平台生成的 item ID。


{
  "capabilityKey": "kuaishou-creator-info-batch",
  "message": "SUCCEEDED",
  "code": 200,
  "data": {
    "taskId": "platform-task-id",
    "batchId": "batch-id",
    "status": "SUCCEEDED",
    "totalCount": 1,
    "succeededCount": 1,
    "failedCount": 0,
    "pendingCount": 0,
    "items": [
      {
        "itemIndex": 1,
        "externalItemId": null,
        "status": "SUCCEEDED",
        "ossUrl": "/api/open/v1/organizations/{orgId}/artifacts/{artifactId}/download",
        "artifact": {
          "creator_name": "户外平头哥（荒野生存）",
          "profile_url": "https://www.kuaishou.com/profile/3x3eiumbwrckuwm?source=SEARCH",
          "kuaishou_id": "lidaliang666",
          "follow_count": 46,
          "fans_count": 12832000,
          "total_likes": 110000000.00000001,
          "bio": null,
          "work_count": 10,
          "works": [
            {
              "publish_date": "2026-05-02",
              "play_count": null,
              "like_count": 191000,
              "title": "探索澳大利亚 前往澳洲北领地，捕获澳洲大泥蟹，解锁不同品种的小龙虾 #户外 #荒野求生",
              "work_url": "https://www.kuaishou.com/short-video/3xfdmx5tiyqaqhg"
            }
          ]
        },
        "errorCode": null,
        "errorMessage": null,
        "startedAt": "2026-05-21T09:00:00Z",
        "finishedAt": "2026-05-21T09:02:00Z"
      }
    ],
    "createdAt": "2026-05-21T09:00:00Z",
    "updatedAt": "2026-05-21T09:02:00Z"
  }
}

取消任务


POST /api/open/v1/organizations/{orgId}/capabilities/kuaishou-creator-info-batch/tasks/{taskId}:cancel
Authorization: Bearer <sk-organization-application-api-key>

取消会停止当前正在运行的底层 session-hub 任务，将未完成 item 标记为 CANCELED，释放共享 douyin-top10 队列，并保留已成功或已失败 item 的原状态。

快手达人信息 批量