WeChat Resolve Channel ID To Username
将微信视频号对外可见的短 ID(`sph...`)解析为 finder username(`v2_...@finder`),供后续账号资料、视频号信息或视频查询使用。 输入: - 必须提供 `request_body` 对象。 - `request_body.channel_id` 必填,例如 `sphi9BjV8GK0Zsl`。必须匹配 `^sph[A-Za-z0-9_-]+$`,总长度不超过 64 个字符。 - `request_body.raw` 为可选布尔值,输入结构中的默认值为 `false`。`false` 返回精简结果,`true` 返回原始分组结果。 返回: - `raw=false` 时,`data.channel_id` 回显输入,`data.username` 为解析出的 finder username,`data.nickname` 为已移除搜索高亮标记的昵称,`data.desc` 为账号简介,可能为 null。精简结果取自原始分组中首个 `@finder` 账号项。未命中时,`data.username` 为 null,`data.error` 提供说明。 - `raw=true` 时,`data.data` 为结果分组,账号项位于分组的 `items` 或 `subBoxes[].items` 中。账号项的 `jumpInfo.userName` 或 `noticeParam.finderUsername` 包含 finder username,`title` 和 `desc` 为展示文本。 响应可能较慢,建议将客户端请求超时设置为 30 秒;超时设置不是工具入参。本工具仅解析账号标识,不直接返回账号的视频列表。
价格说明
| 条件 | 费用 |
|---|---|
| 每次调用 | 20.65积分/次 |
20.65积分/次 按查询次数计费。查询成功但未返回结果时,也会扣除积分。
工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
request_body | object | 是 | 用于将视频号短 ID 解析为 finder username 的请求体对象;channel_id 指定待解析的 sph 开头短号,raw 可选,用于选择原始响应(true)或精简解析结果(false)。 | — |
request_body.raw | boolean | 否 | True=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structure | false |
request_body.channel_id | string | 是 | 视频号 ID(sph 开头的短号)/WeChat Channels ID (short ID starting with sph) | — |
调用示例
复制请求代码,查看对应的返回示例。
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_wechat_resolve_channel_id_to_username' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"channel_id": "sphuqLkqto4uNsU",
"raw": false
}
}
}'{
"code": 200,
"data": {
"debug_id": "201d1116",
"debug_info": "[REDACTED]",
"empty_reason": "bad_input",
"message": "请求参数可能有误(如无效的文章 URL / finder username / 视频 object_id),请检查参数后重试。注意:使用无效参数的请求被微信处理后仍会计费。"
},
"docs": "https://api.tikhub.io/#/WeChat-Channels-V2-API/fetch_channel_id_to_username_api_v1_wechat_channels_v2_fetch_channel_id_to_username_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"channel_id": "sphuqLkqto4uNsU",
"raw": false
}
}返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。





