切换语言

成本

获取 https://api.openai.com/v1/organization/costs

获取组织的成本详细信息。source

查询参数

start_time

整数source

必填

查询时间范围（含）的开始时间（Unix 秒）。source

end_time

整数source

自选

查询时间范围的结束时间（Unix 秒），不包括。source

bucket_width

字符串source

自选
默认为 1d

响应中每个时间桶的宽度。目前仅1d支持，默认为1d.source

project_ids

数组source

自选

仅返回这些项目的成本。source

group_by

数组source

自选

按指定字段对成本进行分组。支持字段包括project_id,line_item以及它们的任意组合。source

限制

整数source

自选
默认为 7

要返回的存储桶数量限制。Limit 的范围可以介于 1 和 180 之间，默认值为 7。source

页

字符串source

自选

用于分页的游标。对应于next_page字段。source

返回

分页、时间分段的 Costs 对象列表。source

示例请求
1
2
3
curl "https://api.openai.com/v1/organization/costs?start_time=1730419200&limit=1" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json"
响应
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
    "object": "page",
    "data": [
        {
            "object": "bucket",
            "start_time": 1730419200,
            "end_time": 1730505600,
            "results": [
                {
                    "object": "organization.costs.result",
                    "amount": {
                        "value": 0.06,
                        "currency": "usd"
                    },
                    "line_item": null,
                    "project_id": null
                }
            ]
        }
    ],
    "has_more": false,
    "next_page": null
}