FOR AI AGENTS · API V1

让 AI 创作，
让你随时接手。

把这个网站链接发给 Codex 或其他支持 API 的 Agent。一个短片可以直接用快速创作：提示词、图片、动作视频、音频和设置都保存到同一份网页草稿。需要改编剧本时，也能整理故事、章节和分镜。

给 Agent 阅读的指南下载完整指南 .md 下载 Skill 包 .zip 登录并连接 Agent

指南和下载公开可用，不需要登录或 API Key。可把 Markdown 文件直接发给 Codex；若网页读取工具打不开，使用同站 HTTPS 直接下载即可。连接账户、读取作品和提交任务时才需要授权。

三步开始

先把链接和创作要求给 Agent。这页、Skill 和机器指南公开可读，无需登录。
登录网站，明确授权一次连接。连接界面上线后，复制短时有效的连接说明给 Agent。辅助脚本在本机生成正式 Key，并通过系统凭据存储保存；无需安装我们的 AI Registry。正式 Key 不进入聊天或链接。当前页面是否提供连接按钮以实际前端发布为准；手动 API Key 是高级备用方式。
回网站看结果，再继续调整。打开同一云故事，查看活动和任务；定位章节、角色或镜头，修改要求后只重做需要的部分。旧候选保留，选中哪一版由你决定。

分享链接只用于发现功能。写入需要账户授权；生成还取决于当前服务是否启用、输入是否合格和可用预算。此页不代表 GPU 已上线。

可直接发给 Agent 的任务示例

“阅读这个网站的 /for-agents 使用指南。用我已配置的凭据，为这个广告想法创建一个快速视频草稿，把我的图片、动作视频和音频放到对应位置，返回网页让我继续修改。生成前核对可用能力、阻塞原因和费用；只有在我已经授权的范围内才提交。结果先放候选，不覆盖我已选择的版本。”

如果你在做短剧，可以要求 Agent 建立章节、角色和分镜；同一份故事也能在快速创作中单独调整某个镜头。

Agent 的调用顺序

Discover
Read the public skill; no key is needed to learn the contract. A shared URL alone does not authorize editing or spending.
Connect
Use the owner's one-time connection grant and OS-protected helper, or an explicit existing scoped PAT. Then GET the authenticated guide, guided schema and capabilities. Use OpenAPI for exact endpoint bodies.
Check mode availability
GET authenticated /v1/generation-availability for the exact deployment profile and FL/REF mode before choosing, preflight and a new submission. Ready/busy can proceed to preflight; starting waits. For unavailable/disabled, preserve the draft and ask an administrator; unknown/expired needs a fresh observation. Never rent automatically or change modes to bypass capacity.
Choose a workflow
For conversation sessions and editable job cards, follow this guide's quick_chat contract and authenticated /v1/quick-chat/schema. The website conversation assistant is disabled by default; external Agents can create cards directly. Optional short-title metadata is described by creation_titles. The following project steps remain the supported legacy freestyle/story workflow. Neither path submits generation while authoring.
Edit
Read the current project/version, then POST atomic guided actions with expected_version. On 409 read again and reconcile; preserve unrelated edits.
Prepare media
Upload into the same project, wait for ready, then shot.configure_generation saves prompt, controls and separate receipt-ID input slots. It maintains web associations; asset.attach remains available for general library editing. Preserve originals and explicit selections.
Plan and submit
Read the saved generation-draft and its project_version, then POST that shot's generation-plans with expected_version. Inspect effective settings, output shape, blockers and estimate; only then, within user authorization/budget, POST a ready plan_id to jobs using one durable Idempotency-Key.
Observe
Poll the original job or owner/project-scoped /v1/job-events with its stable cursor, bounded backoff and Retry-After. Read cancellation reason and retry_advice; null charge/upstream means unknown. A timeout or submission_unknown is unresolved; reconcile the original receipt, never resubmit with a new key. Retry only explicitly through the linked Quick Chat item-retry contract after fresh preflight.
Review and adopt
Verify successful artifacts, adopt video/audio into the intended shot using guided actions, and GET the document again. Preserve existing takes until an explicit selection change.
Return to the website
Return the story/entity link, job ID and actual outcome. The user can inspect activity, open the affected section, adjust inputs and request a new take; unsaved browser drafts require an explicit reload decision.

用对话和任务卡创作

机器指南的 quick_chat 和认证后的 /v1/quick-chat/schema 提供完整示例：创建会话 → 上传素材 → 创建任务卡 → 预检 → 明确确认 → 查询原任务和下载结果。外部 Agent 可直接提交完整提示词，使用 assistant_mode=none、create_card=true，继承会话素材及 next_settings；网站聊天助手默认关闭，不影响直接创建卡片，也不会因此自动生成。

直接创建或修改卡片时，明确携带已选 deployment_profile_id、生成方式和参数；新卡片读取会话设置，修改已有卡片读取原版本。省略配方不会继承会话选择，而是走旧路由。先查配方专属能力与限制，不为绕过阻塞而换模型。普通生成 Key 不具有租 GPU 权限。

会话素材须通过同源 /v1/quick-chat/sessions/{session_id}/assets 上传，不操作隐藏项目。辅助脚本的 upload/resume-upload 支持 --session，会话与原有 --project 参数互斥。Quick Chat 网页有独立发布步骤，返回的 /quick-chat 地址不保证当前部署已能打开；先返回会话、卡片、任务 ID 和经核验的下载结果。用户不需要安装我们的 AI Registry。

修改同一张卡片时，先读取当前卡片，再读取它的 current_revision_id。向 /v1/quick-chat/sessions/{session_id}/cards/{card_id}/revisions 提交完整的新版本，使用卡片的整数 version 作为 expected_card_version；会话的 expected_version 不能用于这里。明确复制模型配方、参数、素材和份数，再改用户指定的内容。source_revision_id 只是可选的同会话来源记录；要保留原名称则显式复制 title。保存版本不会生成视频。完整请求与错误修正示例见公开 Markdown 指南和 Skill。

启用自动命名后，新建时未指定标题的创作会用 gemma-4-31b-it 从第一段文字或任务卡提示词生成一次短标题，只用于创作记录；不会发送素材或完整对话。明确指定的名称和手动改名会保留，失败也不影响创作和视频生成，不会自动重试收费调用。旧记录不会批量改名，浏览记录也不会调用命名模型。这个功能与聊天助手、生成视频分别配置；直接创建卡片也可能触发命名。

原有快速草稿与故事接口

使用本人全部项目范围和 projects:create 权限。为每次新建保存唯一的幂等键；重试原请求沿用原键。返回的 project.journey.reviewShotId 是单镜头 ID。随后用 shot.configure_generation 保存生成设置；创建草稿不会启动 GPU。

{
  "method": "POST",
  "path": "/v1/projects",
  "headers": {
    "Idempotency-Key": "quick-create-001"
  },
  "body": {
    "title": "一束光中的叶子",
    "workspace": "freestyle"
  },
  "read_response": {
    "project_id": "id",
    "project_version": "version",
    "shot_id": "project.journey.reviewShotId"
  }
}

完整的纯文字、参考素材、预检、提交和候选采用示例见机器可读指南。

真实边界

网站公开说明与已授权 API 文档分开。认证后的 /v1/agent-guide、/v1/guided-schema、/v1/capabilities 和 /openapi.json 是调用依据。若生成计划返回阻塞，保留草稿并说明原因；不要把演示素材当成生成成功。

网站聊天助手默认关闭；不支持未配置的图像/音乐/Marble 生成、团队成员共享权限或服务器媒体 ZIP。外部 Agent 可以自行编写完整提示词并保存为任务卡或故事草稿；已有 API Key 不会扩大这些能力。

Skill 包包含完整指南 README.md、SKILL.md、scripts/sixnine.py 和 scripts/connect.py；连接脚本只需 Python 标准库与 Windows 用户 DPAPI、Linux Secret Service 或 macOS 用户 Keychain。macOS 须已有解锁且允许当前进程访问的默认用户 Keychain；脚本不会弹出解锁/授权提示或收集密码，锁定或拒绝访问时会停止。API/媒体辅助脚本还需要 httpx。你也可以直接使用同源 HTTP API，无需安装 Skill。下载不会自动安装或授权。

让 AI 创作，让你随时接手。