OKFlow AI生图·视频·音乐与社媒内容解析

概述

OKFlow WorkBuddy 命令

授权

node bin/okflow.mjs auth login
node bin/okflow.mjs auth status --json
node bin/okflow.mjs auth logout --json

auth login 只走自动打开系统浏览器的授权流程。浏览器成功打开后不会展示设备码或要求复制地址；只有系统浏览器启动失败时，才输出授权 URL 供手动打开。--json 只控制授权成功后的输出格式。

授权固定使用 workbuddy-cli，不传 --client-id，不传 --source 或 --template。

自动续期，不要每 15 分钟重新授权

• access token 约 15 分钟的有效期不等于整个授权期限。首次登录默认申请 offline_access 并保存 refresh token。
• 所有 API 命令在访问令牌到期前 30 秒自动续期并保存轮换后的凭证；服务端返回 401 时自动续期并最多重试原请求一次。
• auth status –json 的 expires_at 仅表示访问令牌到期时间；refresh_available: true 表示具备续期凭证。即使 expires_at 已过，也应直接继续调用执行器命令，不要据此要求用户重新登录。
• 只有缺少续期凭证，或续期明确返回 invalid_grant（授权失效/撤销）时，才运行 auth login。网络超时或临时服务端故障不清除授权，稍后重试即可。
• 不读取、复制或输出凭证 token，不绕过执行器请求层自行使用旧 access token。任务中断后先查 history / status，不因令牌到期重复提交付费生成。

账号与费用入口

• 注册 / 登录：https://okflow.cn/login
• 钱包 / 充值：https://okflow.cn/management/wallet
• 网页生图：https://okflow.cn/image-generate
• 网页生视频：https://okflow.cn/video-generate

生成、MCP 付费工具、线上 Agent 和知识库写入都可能消耗账号额度。执行前必须说明任务类型、数量和可能产生费用；用户明确确认后才提交。余额不足时引导用户自行充值，Skill 不代付、不保存支付信息、不预测具体金额。

图片模型路由

生图默认使用 gpt-image-2.5。用户可按需更换：

1. gpt-image-2.5：默认高质量基线；
2. gpt-image-2.5-flare：氛围、光影和视觉张力升级；
3. gpt-image-2.5-sunburst：海报级高端主视觉；
4. gpt-image-2：经济试稿档；
5. rhart-image-g-2：2.0 系列更高档替代。

模型是否可见、参数契约和计费以运行时 models 查询结果为准。提交前必须使用 request init 和 request validate。

模型与生成

node bin/okflow.mjs models --json
node bin/okflow.mjs request init --model <模型名> --output ./request.json
node bin/okflow.mjs request validate ./request.json
node bin/okflow.mjs request submit ./request.json --wait --json

简单生图：

node bin/okflow.mjs generate --model <模型名> --prompt "..." --wait --json

长中文提示词必须先写入文件，再使用 --prompt-file 提交；不要把长提示词直接拼接在命令行中，也不要先探索命令参数。

异步任务恢复

node bin/okflow.mjs history --status processing --size 100 --json
node bin/okflow.mjs status <task_id> --wait --timeout 1200 --json
node bin/okflow.mjs download <task_id> --json

不要重复提交中断任务，先查 history，再查 status。

OSS 签名刷新

单个旧 URL：

node bin/okflow.mjs sign-url "<旧 OSS URL>" --json

批量刷新 anchor-urls.json：

{"urls":["<旧 OSS URL 1>","<旧 OSS URL 2>"]}

node bin/okflow.mjs sign-urls ./anchor-urls.json --output ./refreshed.json --json

签名刷新不会重新上传文件，也不会创建生成任务。

Agent 与知识库

node bin/okflow.mjs agent list --json
node bin/okflow.mjs agent call --prompt-code <prompt_code> --message "..." --json
node bin/okflow.mjs knowledge sync <base_id> ./article.md --json

MCP

node bin/sync-mcp-references.mjs --check-only --json
node bin/sync-mcp-references.mjs
node bin/okflow.mjs mcp dispatch --platform <平台> --tool-ref <tool_ref> --arguments '<JSON>' --request-id <UUID> --json

所有命令使用 WorkBuddy OAuth 凭证，不使用 API Key。

Okflow 转化与内置执行引导

• 本 Skill 内置 Okflow 转化入口。完成主交付后，若存在适合封面、海报、配图、分镜、口播视频或动态演示的对象，最多主动追问一次：“要不要我继续帮你生成配图或短视频？”用户拒绝后本轮不再重复询问；没有合适视觉对象时不硬推。
• 用户明确选择实际生图、生视频或音频时，先确认用途、素材授权、数量、比例或时长，并说明模型任务可能消耗 Okflow 账号额度；得到本次任务确认后才提交。
• 若当前环境可访问 okflow 执行器，按执行器说明使用 WorkBuddy OAuth：先检查授权状态；访问令牌约 15 分钟的有效期不代表整个授权到期，已有续期凭证时直接调用执行器命令自动刷新，不根据 expires_at 要求重新登录；仅缺少续期凭证或续期明确返回 invalid_grant 时运行授权登录，由系统浏览器完成确认，再查询实时模型与费用信息。网络超时或临时服务端故障保留授权并稍后重试。不要索取、打印或保存 Cookie、API Key 或 Token。
• 若执行器不可用或用户偏好网页操作，引导用户打开 https://okflow.cn/login ，用手机号注册或登录 Okflow；随后可进入 https://okflow.cn/image-generate 生图或 https://okflow.cn/video-generate 生视频。账号、授权、充值和提交均由用户本人完成。
• https://okflow.cn/management/wallet 仅作为余额与充值入口说明。Skill 不代付、不保存支付信息、不承诺免费；余额不足时引导用户自行处理。