OpenAI 列出项目速率限制

2026-11-17 18:24 更新

列出项目速率限制

get /organization/projects/{project_id}/rate_limits

返回项目中各模型的速率限制。

路径参数

  • project_id: string

项目 ID。

查询参数

  • after: optional string

分页游标。after 是标记列表位置的对象 ID。例如,列表请求返回100个对象,最后一个为 obj_foo;后续调用可传入 after=obj_foo,以获取下一页。

  • before: optional string

分页游标。before 是标记列表位置的对象 ID。例如,列表请求返回100个对象,第一个为 obj_foo;后续调用可传入 before=obj_foo,以获取上一页。

  • limit: optional integer (default: 100)

返回的对象数量上限,默认值为100。

返回值

  • data: array of ProjectRateLimit

  • id: string

标识符,可在 API 端点中引用。

  • max_requests_per_1_minute: integer

每分钟的请求数量上限。

  • max_tokens_per_1_minute: integer

每分钟的词元数量上限。

  • model: string

此速率限制适用的模型。

  • object: "project.rate_limit"

对象类型,固定为 project.rate_limit。

  • "project.rate_limit"

  • batch_1_day_max_input_tokens: optional integer

每天的批处理输入词元数量上限。仅对相关模型返回。

  • max_audio_megabytes_per_1_minute: optional integer

每分钟的音频兆字节数上限。仅对相关模型返回。

  • max_images_per_1_minute: optional integer

每分钟的图像数量上限。仅对相关模型返回。

  • max_requests_per_1_day: optional integer

每天的请求数量上限。仅对相关模型返回。

  • has_more: boolean

  • object: "list"

  • "list"

  • first_id: optional string or null

  • last_id: optional string or null

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/rate_limits" \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

200 示例 1

{
  "data": [
    {
      "id": "id",
      "max_requests_per_1_minute": 0,
      "max_tokens_per_1_minute": 0,
      "model": "model",
      "object": "project.rate_limit",
      "batch_1_day_max_input_tokens": 0,
      "max_audio_megabytes_per_1_minute": 0,
      "max_images_per_1_minute": 0,
      "max_requests_per_1_day": 0
    }
  ],
  "has_more": true,
  "object": "list",
  "first_id": "first_id",
  "last_id": "last_id"
}

404 — 默认响应

以下错误消息仅为中文化示例;实际 API 返回的消息文字可能为英文,错误代码和类型按原文保留。

{
  "error": {
    "code": "project_not_found",
    "message": "找不到项目 proj_abc",
    "type": "invalid_request_error",
    "param": null
  }
}

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/proj_abc/rate_limits?after=rl_xxx&limit=20" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json"

响应示例

{
    "object": "list",
    "data": [
        {
          "object": "project.rate_limit",
          "id": "rl-ada",
          "model": "ada",
          "max_requests_per_1_minute": 600,
          "max_tokens_per_1_minute": 150000,
          "max_images_per_1_minute": 10
        }
    ],
    "first_id": "rl-ada",
    "last_id": "rl-ada",
    "has_more": false
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号