Pure Tokens Video
执行边界
当前宿主上下文选择 Pure Tokens 或用户明确指定时,必须调用安装的原生执行器;它是唯一 API 传输,固定请求 https://api.puretokensx.com。不得自行发 HTTP,不回退到 imagegen/Imagen/通用视频 Skill、MCP、代理、Computer Use 或浏览器/桌面自动化。仅执行器在内存中使用当前宿主匹配连接;Skill 不读配置、不传或展示凭据。不需要用户安装 Node、Python、Go 或 Desktop。
从本 SKILL.md 绝对目录解析 ../.puretokens-executor/puretokens-api,Windows 使用 puretokens-api.exe;不依赖 PATH 或工作目录。当前宿主 ID 为 codex、claude-code、workbuddy、gemini-cli、grok-build、opencode、trae、claude-desktop、dsh-desktop 或 zcode,不借用其他宿主连接。远程/沙箱不能访问执行器、连接或附件时报告实际限制,不复制凭据或换传输。
选择与提交
- 默认模型
grok-imagine-video-1.5-preview或用户给定精确 ID:直接读选中的references/profiles/<model>.json。需要选模型、解析别名时才读references/model-index.json,别名必须唯一。不读取所有 profile,也不先查余额、init、doctor、preflight 或实时目录。未知精确 ID 的纯文本请求可只传 model/prompt;字段/操作缺口由执行器按需读取一次目录,查询目录不代替提交权限。 - 只发送 profile 声明的字段、值和 operation;保留用户意图。物理尺寸仅用于比例/输出限制说明,不直接作为 API 尺寸。首帧/让图动起来用
image_to_video,角色风格参考用reference_image_video,参考视频/音频或视频编辑用reference_video/reference_audio/video_edit;首尾帧按所选 profile 的 frame operation。只用已声明的组合混合附件类别,用途不明确时才澄清。每任务一个视频,声音/静音只映射已声明的generate_audio。 - 当前本地附件仅随声明的 multipart 请求发送;用户给出的公网 HTTPS URL 只放入声明的 JSON 字段。不下载、探测、转存参考媒体,不把附件改成提示词。没有声明的传输方式时停止。
- 用宿主文件工具创建 UTF-8 请求:kind=
video、operation=generate或edit、model、prompt、parameters,以及需要的 attachments(field、绝对 path)。执行<执行器> submit --host <当前宿主> --request <绝对请求文件>,完成后清理请求文件。不要把提示词或凭据放进命令行。仅需示例时读references/executor-usage.md。
同任务完成交付
视频默认,在首次 submit 加 --record <工作区或用户指定的绝对任务文件>,使用唯一文件名;不能为切换记录模式重新提交。记录只含任务身份、安全参数及进度,不含 prompt、凭据、参考 URL 或媒体字节。单图短会话可不使用记录;无记录时将原 task_id、original_operation、model、确认数量、安全参数、reconciliation_required、retry_not_before 和 wait_windows_completed 原样带入每次续接。
- 提交一次,立即简短告知返回的 task_id 和状态,然后按
next_step继续。回执缺失/无法解析视为提交未知;仅清理本次临时请求文件后停止,不追加 API 操作、不重提、不猜扣费。 - wait:有记录用
resume --host <host> --record <文件>,否则用wait --host <host> --request <同任务文件>。视频每窗口最多 7 次读取、300 秒,网络与等待均计入。始终遵守 API Retry-After。 - 窗口结束:
ok=true、wait_outcome=window_ended表示仍在生成。只有next_step=wait且原交付授权和当前前台会话仍有效时,再续一个窗口;到累计两个窗口、retry_deferred或next_step=await_user时暂停并询问是否稍后继续。保留 wait_windows_completed,不重置预算,不后台循环。用户取消、返回失败回执、未知状态或对账立即停止;窗口内短暂 429 仅由执行器按 Retry-After 和剩余预算处理;实际网络超时不是正常窗口结束。 - content:只对已完成原任务下载。记录方式用
content --host <host> --record <文件> --index <索引> --output-dir <现有绝对目录>;无记录传 completed 状态及确认数量。图片按 0..n-1,视频仅 0;每次一个索引,实际交付后才取下一个。 - deliver:把 downloaded_paths 的文件用宿主附件方式交给用户;下载不等于交付,URL、HTML、SVG 或任务号不能代替媒体。有记录时,实际交付后再执行
delivered --record <文件> --index <索引>。done后结束,不自动审美检查或生成新任务。
附件交付失败只重交已有文件,不重新生成或下载。已完成且 reconciliation_required 不为 true 的记录用 resume --host <host> --record <文件> 本地校验并返回待交付文件;此分支不读凭据、不请求 API。按 next_step=deliver 交付;缺失有效证明时保留原文件、另选输出目录取同任务索引。跨命令复用须匹配记录中的 SHA-256、字节数和媒体类型。无记录且文件仍是本会话刚下载的原文件,可重交;无法确认则保留文件、另选输出目录取同任务同索引,不声称已交付。宿主无法提供附件时说明“已生成并下载,当前宿主无法交付附件”。
对账不自动续等;用户明确继续时,记录式 resume 只查询原任务一次,按实际结果更新标记。记录不能恢复无 ID 的未知提交,不手改记录或提前标记 delivered。
按需说明
失败只说明实际阶段、是否已有任务和下一步,使用执行器的脱敏 next_action;不展示整份 JSON、原始错误、内部 URL 或配置。失败、额度/费用问题才读 references/failure-guide.md;复杂异常按 id 查 references/behavior-scenarios.json。正式字段见 references/execution-contract.json,展示规则见 references/task-receipt.json,均非普通生成前置。
只有用户明确检查参数时用 preflight,它不创建任务、不报价、不证明权限。特定 Desktop/ZCode 安装或交付问题才读 references/desktop-hosts.md;本地夹具和 init 成功均不等于实机附件验收。ZCode 连接存在不证明当前聊天选择;不据配置存在擅自路由。