aiznt-sora2
Sora2 文生视频:通过天树代理提交生成任务并轮询结果。Use when: 用户指定 sora_video2、sora-2-pro 等模型生成短视频。
- License 许可
- MIT
- 最近更新
- 2026-06-10
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- aiznt-sora2
- metadata
- { "openclaw": { "requires": { "env": [ "AIZNT_PROXY_URLS" ] }, "primaryEnv": "TS_TOKEN" } }
- description
- Sora2 文生视频:通过天树代理提交生成任务并轮询结果。Use when: 用户指定 sora_video2、sora-2-pro 等模型生成短视频。
03 SKILL.md 正文
Sora2 视频 (aiznt-sora2)
本技能在 TsClaw / OpenClaw 技能目录下提供两个 Node 入口:submit 创建异步任务,fetch 按任务 ID 查询状态与产物。所有请求经天树下发的代理 URL 转发,需使用与天树对话一致的 Bearer 凭证。
前置条件
- TsClaw 已登录天树账号,并在 Skills 页对本技能执行「同步天树凭证」或手动保存配置。
- 环境变量(由应用写入
skills.entries,执行时映射为进程环境):TS_TOKEN:天树ts_前缀的对话令牌。AIZNT_PROXY_URLS:JSON 对象字符串,至少包含本技能用到的两个键(见下文)。键名需与后端getAizntProxyByTokenUrls返回字段一致。
代理 URL 键
| 键名 | 用途 |
|---|---|
v2_videos_generations |
POST,提交文生视频请求体(prompt、model 等) |
v2_videos_generations_fetch |
GET,查询任务;模板中可含 {task_id},脚本会替换为实际 ID |
若 URL 模板含 {task_id},不要手写死任务号;先 submit 取回 ID,再传给 fetch。
命令示例
在项目根或技能目录下(保证 node 能加载 scripts/):
# 1. 提交任务(body 为上游要求的 JSON,示例字段仅供参考,以实际模型文档为准)
node scripts/sora2.js submit --body '{"prompt":"A coffee cup on a wooden table, slow pan","model":"sora_video2"}'
# 2. 假设上一步返回中包含任务 id(字段名依上游封装可能为 id / task_id),查询进度
node scripts/sora2.js fetch --task-id <上一步任务ID>
submit 成功返回的 JSON 结构取决于天树网关与上游封装;若只看到嵌套在 data 内的字段,请以实际响应为准解析 task_id。
常见错误
- 401 / 缺少 TS_TOKEN:未同步凭证或
apiKey过期,请在 TsClaw 重新同步或更新天树登录。 - 缺少 AIZNT_PROXY_URLS 某键:凭证接口未返回对应代理路径,需后端配置齐
v2_videos_generations与v2_videos_generations_fetch。 - HTTP 4xx 于 submit:请求体字段名、模型名与上游不一致;对照当前可用的 Sora2 模型列表调整
model与prompt约束。
与 TsClaw 的对应关系
- Skills 配置里
apiKey对应环境变量TS_TOKEN(primaryEnv: TS_TOKEN)。 env.AIZNT_PROXY_URLS为整段 JSON 字符串;本技能运行时只需上述两个键的非空值。
维护说明
脚本使用 Node 18+ 全局 fetch,无额外 npm 依赖。修改代理行为时请同步更新 scripts/client.js 中的 loadClient / fetchJson 与本文档中的 URL 键表。
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
touchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
teams-meeting-pipeline
Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.