快手发布
本版本快手视频固定采用「先发私密作品,再把简介交给用户手动补齐并公开」的协作流程。 接到视频发布任务时说明这一限制;已有该流程的发布授权就直接执行,不逐条重复询问是否改走私密暂存。具体顺序:
- 准备成片与最终简介(含话题),保留简介供交付;平台提交为空简介、
--visibility private。 - 按下述方式本地预览,按需登录,再加
--confirm提交私密作品。 - 确认私密提交结果后,把完整可复制的简介正文(含话题)直接发给用户,同时说明:请在快手 App 找到这条私密作品,手动补简介、按需完成平台声明,再自行改为公开。不能只给简介文件路径或让用户自行找文案。
- 如实告知审核/作品识别状态,保留原收据与发布记录;用户完成公开后沿用原记录核实,不另发一条作品。
话题上限:快手平台单条视频描述最多支持4个 hashtag(#话题)。准备和交付简介时先核对数量,超过4个须精简至4个以内;交给用户在 App 手动补填的简介同样适用。
索取扫码前,先按目标内容运行不带 --confirm 的发布预览,完成媒体、可见性、简介和参数能力检查。预览不访问平台;通过后才检查 kuaishou-publish check,需要登录时使用 kuaishou-hunter login。
kuaishou-publish methods 返回支持参数及取值。
kuaishou-publish publish --text @/绝对路径/body.txt --image /绝对路径/image.jpg --source-folder /绝对路径/kuaishou/outputs/作品 --account default
kuaishou-publish publish --text @/绝对路径/body.txt --image /绝对路径/image.jpg --source-folder /绝对路径/kuaishou/outputs/作品 --account default --confirm
默认只预览,不访问平台。多行正文先保存为 UTF-8 纯正文文件,用 --text @/绝对路径/body.txt 由脚本读取;不要用 $(cat ...) 或将多行文案拼进命令。路径含空格时给整个 @路径 参数加引号;文件只放正文和话题。媒体用真实本地文件。--record-title 可指定记录标题。视频与图集二选一;图集 1–31 张、每张不超过 15MB,可见范围 public/private/friends。没有 --cover/--mention/--poi 等选项。私密图集接口有平台验证记录;没有自动删除接口。
视频接口目前仅覆盖空简介、仅自己可见、立即发布的分支,已实号确认可提交并进入审核。审核通过与实际可见仍须分别核查。已有上述协作流程的发布授权时使用:
kuaishou-publish publish --video /绝对路径/video.mp4 --visibility private --record-title "测试记录标题" --source-folder /绝对路径/kuaishou/outputs/测试 --account default
--record-title 只用于本地记录,不向平台提交标题。视频不要传 --title、非空 --text、--tag、--topic 或 --schedule;未指定 --visibility private 也会在上传前拒绝。正式公开视频及带简介的视频交用户在原平台完成,不建议靠养号、等待或改参数绕过未支持的分支。
参数支持范围以 kuaishou-publish methods 的 constraints 为准,本地能力限制应明确说明来源,不能表述成平台已拒绝本轮内容。
私密视频暂存默认 distribute_status=1(当前无需分发);有实际分发计划时可显式传 --distribute-status 0,2 表示已分发。该参数仅用于本地记录,不提交平台;其他发布分支保持 published-track 原默认值,补录时按实际需求填写。
核对文本、媒体、账号、可见范围与声明后,已有发布授权时加 --confirm。
脚本串行发布并保存 publish-result.kuaishou.json。平台明确接受提交、且取得创作者作品 ID 后可入库;私密/审核中的数字 publishId 或 workId 不等于公开短链 ID,url:null 不表示发布失败,不拼造 /short-video/<数字ID> 分享链接。无公开链接时 published-track 仍记录作品目录、账号和创作者 ID(保存在 notes 的 platform_runtime 字段),供本人取数匹配;以后取得真实公开链接再补入库。
published:true, recorded:false 表示作品已识别、记录失败,重跑同一目录只补入库。accepted:true, resolution_pending:true 表示平台已接受提交,但作品 ID 尚待确认;保存 accepted 收据,不能将上传 fileId 当作品 ID,先检查 kuaishou-engagement list 或原平台,不重发。已有 submitting/unknown 结果文件时禁止重发,先核查并由用户确认结果;不要删除收据换目录重发。下一条独立作品使用新的作品目录。
提交结果与实际可见、审核通过分开记录。返回失败、风控或超时后停止,不换通道重发。发布调用和结果文件不负责平台指标采集。
兼容字段 published:true 表示已取得可记录的作品 ID。实际状态看 result.publication 的 accepted、id_resolved、private、public、review_pending、playable;null 表示未验证。ownership_status:ownership_unverified 表示主站登录 ID 与创作者作者 ID 的映射尚未验证,不能凭同昵称或跨命名空间字符串直接认定同号/错号。用户在 App 完成公开后,用 kuaishou-engagement 取本人作品核实并沿用原记录补充。
失败时查看返回的 diagnostic 和收据中的 error_message / diagnostic:保留脱敏消息、平台 result、HTTP 状态、请求阶段与路径;不含原始响应正文或凭据。只有 RISK_CONTROL 或平台明确说明验证/风控时才按风控处理,裸 UPSTREAM 不能据此判断。私密作品核查使用 kuaishou-engagement list 的创作者会话;公开 hunter 列表为空不能证明提交失败。保留收据,不自行删除后重发。