1. 登录并创建项目
- 访问 modelriver.com 并注册账号。
- 为你的第一个项目命名,例如“Production”或“Staging”。项目会隔离凭证、工作流和日志。
- 如果队友也需要访问控制台,可从用户菜单中邀请他们加入。
2. 连接 AI 供应商
- 打开 Settings → Providers。
- 为你计划使用的每个供应商粘贴 API Key,例如 OpenAI、Anthropic、Google、Cohere、Mistral,或自定义端点。
- 点击保存。ModelRiver 会立即加密凭证。后续你可以随时轮换或删除。 在项目侧边栏中,堆叠服务器图标会直接带你进入该页面。
3. 为你的应用创建 API Key
- 在项目内进入 API Keys。
- 点击 Create Key,填写一个易识别的名称,然后复制生成的 Key。Key 只会展示一次,请保存到你的密钥管理系统中。
- 你可以随时吊销 Key,变更会立即生效。 当你准备创建新凭证时,可以在侧边栏中找到钥匙图标入口。
4. (可选)定义结构化输出
- 打开 Structured Outputs,点击 New Structure。
- 填写名称、可选描述,以及模型需要遵守的 JSON Schema。
- 将该结构绑定到某个工作流,或在调用 API 时直接引用它。
5. 构建工作流
- 进入 Workflows,点击 Create Workflow。
- 选择主供应商/模型,可选添加最多两个回退模型;如果需要稳定 JSON 输出,可附加结构化输出。
- 添加缓存字段,例如
user.email或messages.0.content,让关键请求数据在响应和日志中可见。 连接节点图标代表 Workflows 区域;保存后可通过播放按钮进入 Playground 验证配置。
6. 发出第一条请求
使用你的新 API Key 调用统一端点:
Bash
curl -X POST https://api.modelriver.com/v1/ai \ -H "Authorization: Bearer mr_live_your_key" \ -H "Content-Type: application/json" \ -d '{ "workflow": "marketing-summary", "messages": [ {"role": "user", "content": "Summarise this week's launch"} ] }'查看响应后,打开 Request Logs 检查这次执行。提示词、响应、Token 用量和缓存数据都会被记录下来。