项目

项目用于为配置、密钥和请求划分清晰的使用范围。它适合隔离不同产品、应用、环境或客户的 AI 流量。

什么时候应创建项目

• 同时维护多个应用。
• 需要隔离开发、测试和生产环境。
• 需要按客户或部门归类配置和请求。
• 希望为配置和请求使用稳定范围。

如果只有一个简单的个人调用场景，可先不创建项目，直接完成快速开始。

创建项目

1. 进入 项目。
2. 点击 创建项目。
3. 填写项目名称。
4. 确认或修改项目 slug。
5. 保存。

项目名称用于控制台展示；slug 是更稳定的机器可读标识。建议 slug 使用小写英文、数字和连字符，例如 customer-support-prod。

将配置归类到项目

编辑项目时，可从已有配置 API 中选择项目配置。

一个配置同一时间只能归属于一个项目。将它分配到新项目时，应先确认相关客户端和自动化配置已同步更新。

配置与 Access Key 一对一绑定，因此将配置归类到项目后，对应 Key 的请求也会具有该项目范围。

推荐的组织方式

按产品

customer-support
content-studio
internal-copilot

按环境

app-development
app-staging
app-production

按客户或部门

client-a
client-b
research-department

对生产和测试环境，建议使用不同配置 API 和 Access Key，不要仅依赖项目名称区分。

项目边界

项目本身不会：

• 自动创建上游 Key。
• 自动检测模型。
• 自动生成配置 API。
• 自动复制或转移客户端中的 Access Key。

它是组织与查询范围，实际调用能力仍由上游、模型资源和配置 API 共同决定。

修改项目

可修改项目名称、slug 和关联配置。修改前请考虑：

• 是否有自动化工具依赖当前 slug。
• 是否会将配置从另一项目中移出。
• 是否有外部系统使用项目名称作为筛选条件。

项目设计示例