几分钟内完成 ModelRiver 配置

把所有 AI 供应商接入同一个统一网关。无需自建基础设施,即可实现模型故障切换、结构化输出和实时流式响应。

1. 登录并创建项目

  1. 访问 modelriver.com 并注册账号。
  2. 为你的第一个项目命名,例如“Production”或“Staging”。项目会隔离凭证、工作流和日志。
  3. 如果队友也需要访问控制台,可从用户菜单中邀请他们加入。

2. 连接 AI 供应商

  1. 打开 Settings → Providers
  2. 为你计划使用的每个供应商粘贴 API Key,例如 OpenAI、Anthropic、Google、Cohere、Mistral,或自定义端点。
  3. 点击保存。ModelRiver 会立即加密凭证。后续你可以随时轮换或删除。 在项目侧边栏中,堆叠服务器图标会直接带你进入该页面。

3. 为你的应用创建 API Key

  1. 在项目内进入 API Keys
  2. 点击 Create Key,填写一个易识别的名称,然后复制生成的 Key。Key 只会展示一次,请保存到你的密钥管理系统中。
  3. 你可以随时吊销 Key,变更会立即生效。 当你准备创建新凭证时,可以在侧边栏中找到钥匙图标入口。

4. (可选)定义结构化输出

  1. 打开 Structured Outputs,点击 New Structure
  2. 填写名称、可选描述,以及模型需要遵守的 JSON Schema。
  3. 将该结构绑定到某个工作流,或在调用 API 时直接引用它。

5. 构建工作流

  1. 进入 Workflows,点击 Create Workflow
  2. 选择主供应商/模型,可选添加最多两个回退模型;如果需要稳定 JSON 输出,可附加结构化输出。
  3. 添加缓存字段,例如 user.emailmessages.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 用量和缓存数据都会被记录下来。

下一步