> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meoo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 仅生成接入

适用于使用 Meoo 完成 AI 生成、预览和源码交付。

## 前置选择

按认证与授权取得业务 Bearer 凭证。系统集成统一使用团队版：单一大账号使用 Owner 临时 Token，需要最终用户隔离时使用虚拟成员临时 Token；用户 API Key 仅用于个人测试。完整流程的最小 Scope：project.write project.read agent.run agent.read source.read；按实际使用增加 skill.write 或 cloud.\*。如果不需要导出源码，可以不申请 source.read。

## 接入流程

获得业务 Bearer 凭证 → 创建或选择项目 → 创建 Agent Run → 消费 SSE、处理 Action → 查询会话和消息 → 获取短期预览地址 → 创建源码导出 → 下载并校验 ZIP

1. POST /open/v1/projects 创建项目并保存 project\_id。
2. `POST /open/v1/projects/{project_id}/agent/runs` 提交自然语言需求。
3. `GET .../agent/runs/{run_id}/events` 实时读取进度。断线后退避重订阅同一 Run，通过 `message.snapshot` 校正文本和工具状态；SSE 帧 ID 只在本次连接内有效，不支持 `Last-Event-ID` 断点续传。
4. 遇到交互 Action 时调用 POST .../agent/action-responses。
5. 使用会话和消息接口恢复上下文；生成成功后调用 POST .../agent/preview-links。
6. 验收生成结果后，调用 `POST /open/v1/projects/{project_id}/source-exports` 创建当前源码导出。使用响应中的短期 download\_url 下载 ZIP，并按 size 和 sha256 校验完整性。 完整请求、SSE 事件和 Action 结构见 [Agent 接入总览](/open/agent/overview)

### 展示素材与积分

通过 Bash 的 `tool.call.sub_type` 区分普通命令、图片、视频、语音和音乐生成，`tool_name` 仍为 `Bash`。参数生成完成后才首次发送 `started`；完成时结合 `outcome` 判断成功与否，并使用可选的 `result` 展示素材。重连 `message.snapshot.tool_calls` 可恢复素材类型、状态和可公开产物；普通 Shell 命令不进入工具快照。

主 Agent 与素材可分别发送 `run.usage`，每条 `credits_used` 是单笔积分。按 Run 保存 `usage_id` 集合和积分累计值，先去重再求和，避免重连重复累计。该事件没有 `tool_call_id` 或 `sub_type`，不要按事件顺序绑定某次生成；没有积分事件也不代表零消耗。详细字段和例子见 [事件流与 Action](/open/agent/events)。

## 导出源码

源码导出是同步接口，可能包含恢复沙箱、打包和上传过程，客户端超时时间建议设置为 240 秒。成功响应为 201 Created，包含 filename、size、sha256、download\_url 和 download\_url\_expires\_at。

● download\_url 默认有效期为 10 分钟，应在可信服务端立即下载。

● 下载链接可以直接读取项目源码，不能写入日志、数据库、分析系统或返回给无关用户。

● ZIP 会排除 Git 元数据、依赖、构建缓存、平台临时文件及 .env、.env.\* 文件。 ● 下载链接过期后重新创建导出，不要修改签名参数。

● 项目体积较大时不要高频并发重试；请求结果不确定时先退避，再有限重试。 完整字段、示例和错误处理见源码导出 API。

## 与全链路的区别

● 不请求 release.write、release.read，也不调用 Release API。

● 预览地址是短期验收入口，不是正式网站链接；过期后重新签发。

● 源码 ZIP 是交付产物，但不产生线上版本或正式网站地址。

● 后续决定上线时，可在同一 project\_id 上继续走全链路发布，无需重复生成。

## 完成标准

● Run 创建、事件消费、断线恢复和 Action 回复可重试且不产生重复任务。

● 可展示素材生成进度与产物；积分按 `usage_id` 去重累计，并保存恢复所需状态，不依赖缓存重放或历史消息补齐全部历史积分。

● 会话与项目映射可恢复，不向其他用户暴露当前 project\_id。

● 源码导出使用与项目相同的身份，下载完成后校验 size 和 sha256，且不泄露临时下载链接。

● 错误的 code、message、details、request\_id 完整进入接入方诊断链路。

● 产品界面明确标注预览地址的临时性质。
