Source: https://01router.com/zh/docs/projects
Base URL: https://01router.com/api/v1

# 项目机制

项目是接入的基本单位：每个项目有自己的 API Key、模型范围、供应商和价格比例。用项目的 Key 调用接口时，项目配置会自动生效；你的前端还能用项目 ID 拉取带售价的模型目录。

## 读取项目模型目录

```bash
curl 'https://01router.com/api/v1/models?project=YOUR_PROJECT_ID&type=video'
```

## 调用自定义模型 ID

```bash
curl 'https://01router.com/api/v1/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "my-video-lite",
  "input": {
    "prompt": "A red fox running through fresh snow, cinematic"
  }
}'
```

## 按项目配置报价

```bash
curl 'https://01router.com/api/v1/quote' \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.5",
  "input": {
    "prompt": "A red fox running through fresh snow, cinematic"
  },
  "project": "YOUR_PROJECT_ID"
}'
```

## 使用说明

- 在控制台「项目」页创建项目，一个账户最多 20 个项目，每个项目最多 20 个 API Key。新项目默认启用全部模型、价格比例 100%。所有项目共用账户积分余额。
- 开启「全部模型」时，平台目录里的模型都能调用，未单独配置的模型自动走最便宜的供应商；关闭后只能调用单独配置过的模型，其余模型返回 400（Model xxx is not enabled in this project）。
- 单独配置模型时可以固定供应商、设置价格比例和排序（数字越小越靠前）。固定供应商后，该模型的请求只发往这个供应商，请求里的 provider 字段会被忽略。
- 可以为同一个平台模型再上架一个自定义模型 ID（小写字母、数字、. _ -，最长 64 位，不能与平台模型重名），绑定另一个供应商和名称，例如同时提供标准版和低价版。调用时 model 填自定义 ID 即可。
- 价格比例取 1–1000 的整数（100 = 平台原价，120 = 加价 20%），只影响项目模型目录里展示给你的用户的售价。实际扣费始终按平台价从你的账户积分扣除，差价由你在自己的产品中向终端用户收取。
- GET /api/v1/models?project=YOUR_PROJECT_ID 公开可读、无需密钥，返回已启用的模型、参数和按比例换算后的价格（美元），可追加 type 过滤。项目 ID 可以放在前端，API Key 不可以。填写项目域名后，只有该域名及其子域名下的浏览器能跨域读取；不填则允许任意来源。
- 每个 API Key 都属于一个项目，请求会自动使用该项目的配置，请求体里的 project 字段可以省略；如果填写，必须与 Key 所属项目一致，否则返回 403。报价接口 /quote 无需密钥，可传 project 按项目的模型映射和供应商报价（返回平台价）。
- 每个 Key 可设置：额度上限（积分，可选择不重置或按天 / 周 / 月重置，并指定时区），超出返回 429 quota_exceeded；IP 白名单（最多 50 条，支持 IPv4 CIDR），不在名单内的请求按无效 Key 处理；有效期（1 / 7 / 30 / 90 / 180 / 365 天或永久）。删除项目后，其模型目录与 Key 的调用都会失效。