Skip to Content
平台能力抖快数据获取快手达人信息 单条

快手达人信息 单条

kuaishou-creator-info-single 用于创建单次快手达人信息采集任务。调用方传入快手号,平台会通过 session-hub 获取该账号前十条作品信息,并把快手结果 JSON 作为整份 artifact 返回。

能力信息

字段
能力 Keykuaishou-creator-info-single
能力名称快手达人信息 单条
能力类型workflow_execute
共享队列douyin-top10

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

开始任务

POST /api/open/v1/organizations/{orgId}/capabilities/kuaishou-creator-info-single:execute Authorization: Bearer <sk-organization-application-api-key> Content-Type: application/json
{ "applicationId": "organization-application-id", "input": { "kuaishouId": "lidaliang666" } }
字段必填说明
applicationId调用方团队应用 ID。传入时必须和 API Key 绑定的应用一致;不传时平台会使用 API Key 绑定的应用。
input.kuaishouId快手号。底层提示词为 获取快手号%s的前十条作品的信息
{ "capabilityKey": "kuaishou-creator-info-single", "message": "SUCCEEDED", "code": 200, "data": { "taskId": "platform-task-id", "status": "RUNNING", "request": { "kuaishouId": "lidaliang666" }, "result": null, "error": null, "artifacts": [], "createdAt": "2026-05-21T09:00:00Z", "updatedAt": "2026-05-21T09:00:01Z" } }

Agent CLI 映射

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

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

查询当前运行任务

快手达人信息能力与抖音 Top10 能力当前共享底层 douyin-top10 远端资源队列。队列容量由平台配置决定;所有 slot 都被占满时,新的快手达人信息或 Top10 创建请求会返回 409

GET /api/open/v1/organizations/{orgId}/capabilities/kuaishou-creator-info-single/current-task Authorization: Bearer <sk-organization-application-api-key>
{ "capabilityKey": "kuaishou-creator-info-single", "message": "SUCCEEDED", "code": 200, "data": { "running": true, "queueKey": "douyin-top10", "ownerCapabilityKey": "douyin-top10-batch", "taskId": "platform-task-id", "executionId": "platform-execution-id", "status": "RUNNING", "acquiredAt": "2026-05-21T09:00:00Z", "activeCount": 2, "capacity": 2, "owners": [ { "slotIndex": 0, "ownerCapabilityKey": "douyin-top10-batch", "taskId": "platform-task-id", "executionId": "platform-execution-id", "status": "RUNNING", "acquiredAt": "2026-05-21T09:00:00Z" }, { "slotIndex": 1, "ownerCapabilityKey": "kuaishou-creator-info-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]。新接入方应优先读取 activeCountcapacityowners,用于判断共享队列当前占用情况。

如果队列 owner 是其他能力,例如 douyin-top10-batch,调用方应使用 ownerCapabilityKeytaskId 查询对应任务。所有 slot 都被占满时,新的快手达人信息或抖音 Top10 创建请求会返回 409

查询任务

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

成功后 data.result 是快手结果结构本身,不会拆成子条目,也不会返回平台生成的 item ID。

{ "capabilityKey": "kuaishou-creator-info-single", "message": "SUCCEEDED", "code": 200, "data": { "taskId": "platform-task-id", "status": "SUCCEEDED", "request": { "kuaishouId": "lidaliang666" }, "result": { "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" } ] }, "error": null, "artifacts": [ { "id": "artifact-id", "taskId": "platform-task-id", "artifactType": "DOCUMENT", "title": "快手达人信息 - lidaliang666", "mimeType": "application/json", "downloadUrl": "/api/open/v1/organizations/{orgId}/artifacts/{artifactId}/download" } ], "createdAt": "2026-05-21T09:00:00Z", "updatedAt": "2026-05-21T09:02:00Z" } }

取消任务

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

取消会停止底层 session-hub 任务,释放共享 douyin-top10 队列,并把平台任务状态更新为 CANCELED

Last updated on