higgsfield-to-social

用途 把一次提示词生成的内容变成多平台发布的帖子。生成交给 Higgsfield CLI，发布交给 Upload-Post，可在平台支持时标注为 AI 生成内容。仓库描述提到的模型包括 Seedance、Kling、Veo、Nano Banana、GPT Image、Soul 与 Marketing Studio 广告。

前置条件

• Higgsfield CLI 需在 PATH 中。若缺失，引导用户到 https://github.com/higgsfield-ai/cli 自行安装（Homebrew、npm 或安装脚本），不要代替用户把安装脚本管道到 shell。
• Higgsfield 会话：若 higgsfield account status 显示 Not authenticated 或 Session expired，请用户运行 higgsfield auth login 并等待。
• Upload-Post 二选一：MCP 连接器 https://mcp.upload-post.com/mcp（优先，OAuth，无需在提示词中放密钥）；或环境变量 UPLOAD_POST_API_KEY，以 Authorization: Apikey $UPLOAD_POST_API_KEY 发送。
• 至少一个社媒账号已连到某个 Upload-Post profile；没有则引导到 https://app.upload-post.com/manage-users 或通过 MCP 调 get_connect_link。

主要流程

1. 先确定发布目的地：用 list_users 或 GET https://api.upload-post.com/api/uploadposts/users 列出 profile 与已连账号，使用响应中的准确用户名，跳过 reauth_required: true 的账号并提示重连。
2. 按平台选格式：TikTok、Reels、YouTube Shorts 用 9:16 视频（5 到 12 秒通用）；Instagram feed、Threads、Bluesky 用 4:5 或 1:1 图片或视频，轮播最多 10 张图；YouTube 长视频、X、LinkedIn、Facebook 用 16:9 视频（YouTube 需标题）；Pinterest 用 2:3。若目标冲突，询问是统一做竖版还是按格式各生成一版，并说明按格式分开效果更好但耗费更多 credits。
3. 生成：用户未指定模型时，视频默认 seedance_2_5，图片默认 gpt_image_2_5 或 nano_banana_flash；不确定参数时用 higgsfield model get <model> --json 查看，较长生成前先用 higgsfield generate cost ... 报价。示例命令：higgsfield generate create seedance_2_5 --prompt "..." --aspect_ratio 9:16 --duration 8 --resolution 1080p --wait --json；图片用 gpt_image_2_5 并设 --aspect_ratio 4:5。带 --wait --json 返回完成任务，从中取公开 https:// 结果 URL。
4. 视频可选打分：发布前可提供 Virality Predictor：higgsfield generate create brain_activity --video <job_id_or_path> --wait，报告总分、hook 秒数与报告链接；若 hook 弱可只改写开头（第一秒有运动或切镜、主体第一帧入画、不要慢淡入）后重生成并对比两版，最多重试两轮除非用户明确要求更多。分数只供参考，不阻止发布。
5. 确认：按平台分别写文案，不共用一条。TikTok 2,200 字符、结尾 3 到 5 个话题标签；Instagram 2,200 字符、最多 30 个标签；YouTube 标题 100 字符、正文进描述；X 标准账号 280 字符；Threads 500 字符；Bluesky 300 字符；LinkedIn 3,000 字符；Pinterest 标题 100 字符。向用户展示结果 URL、目标 profile 与平台、各平台文案及长度对照表、是立即发布/入队/定时。用户可逐条修改，每次修改后重新展示表格，只有最终版本获得明确同意才发布。
6. 发布：直接把 Higgsfield 结果 URL 传给 Upload-Post，由其抓取，无需下载。始终发送 AI 生成标记：is_ai_generated=true（TikTok AI 标签、YouTube 合成媒体披露）。MCP 用 upload_video，图片用 upload_photos；HTTP 用 POST https://api.upload-post.com/api/upload（图片用 /api/upload_photos，每张一个 photos[]），各平台文案通过 <platform>Title（MCP）或 <platform>_title（HTTP）传，title 为兜底；scheduledDate / scheduled_date 定时，addToQueue: true 入队。
7. 回报：用 get_status（MCP）或 GET https://api.upload-post.com/api/uploadposts/status?request_id=<id>（定时或排队用 job_id）轮询，按平台返回 post_url，或把 error_message 用平实语言说明。TikTok 可能需要几分钟；fallback_to_inbox: true 表示进入账号草稿，需在应用内发布。

常见错误 Higgsfield 未认证或会话过期需用户重新登录；Upload-Post 401 多为密钥或 Bearer 方案错误，应使用 Apikey；平台未连到 profile 需在 Manage Users 连接或去掉；YouTube 缺标题会被拒；Instagram 拒收多为比例或时长超范围，需按 9:16（Reels）或 4:5（feed）重生成且不短于 3 秒；reddit_unavailable (503) 表示上游暂停 Reddit 发布，先不包含 Reddit。

限制与规则 未获用户对最终媒体与文案的明确同意，不得发布、排期或入队；始终发送 AI 生成标记，不得把生成内容当作真实素材；只用 list_users 返回的 profile 名；长时间或批量生成前先报 Higgsfield 费用。

适用场景 需要把 AI 生成的图或短视频一次性分发到多个社媒平台，并对文案、比例、AI 披露与发布时间做统一管理的场景。