1. 准备服务地址
2. 选择接入方式
2.1 OAuth:第三方应用代用户访问
联系 Meoo 客服创建第三方应用,并提供应用名称、应用描述、HTTPS 图标地址、回调地址、应用类型和需要的 Scope。Web 应用会获得:state、code_verifier 和 code_challenge:
code 和 state 后,必须先一次性校验并消费 state,再由服务端兑换 Token:
access_token、refresh_token、expires_in、scope 和当前 Client 隔离的 openid。
2.2 API Key:仅限个人测试和自己的自动化
用户在 Meoo 设置页创建 API Key,并选择具体 Scope 或“全部权限”。明文只展示一次:2.3 团队系统集成
如果接入方以一个团队账号承载多个外部用户,不需要为每位用户执行 OAuth。现阶段由接入方提供团队账号、秒悟团队创建测试 AK/SK;获得凭证后,接入方在可信服务端完成:3. 发起第一个资源请求
OAuth 和 AK 只在 Bearer 值上不同,业务接口完全一致:url_id、Token 和 next_page_token,不要尝试解析其结构。
4. 下一步
- 要创建项目、驱动 AI 生成并读取会话历史:申请
project.write agent.run agent.read,从 Agent 接入指南 开始,字段索引见 Agent OpenAPI。 - 要上传自定义 Skill:申请
skill.write,上传成功后只需agent.run即可在 Run 中使用,参见 Skills API。 - 要读取 Storage:申请
cloud.storage.read。 - 要发布 Web 项目当前的生成结果:申请
release.write,并为发布请求生成Idempotency-Key。App 安装包和小程序平台发布暂未通过 OpenAPI 开放。 - 上线前完成 运行与安全检查。

