@leaflow/sdk 0.6.0 → 0.7.0

package/dist/canopy/v1/schema.d.ts

@@ -0,0 +1,1100 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/api/v1/keys": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 列出 API Key */
+        get: operations["list-api-keys"];
+        put?: never;
+        /**
+         * 签发一把 API Key
+         * @description 响应里的 `secret` 是完整的 key，**只在这一次出现**——服务端只存它的哈希，之后任何接口都不会再返回它。丢了只能撤销重建。
+         *
+         *     把它填进 `OPENAI_API_KEY` 一类的地方即可，转发接口同时接受 OpenAI、Anthropic、Gemini 三种调用格式。
+         */
+        post: operations["create-api-key"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/keys/{keyId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 查看 API Key */
+        get: operations["get-api-key"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * 修改 API Key
+         * @description 只改属性，不改状态——启用、停用、撤销各有自己的接口。
+         *
+         *     没提到的字段保持不变。要把到期时间改成「永不过期」请传 `clear_expiry: true`，而不是把 `expires_at` 传成 null。
+         *
+         *     已撤销的 key 不接受任何修改。
+         */
+        patch: operations["update-api-key"];
+        trace?: never;
+    };
+    "/api/v1/keys/{keyId}/disable": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 停用 API Key
+         * @description 临时停用，随时可以启用回来。要永久失效请用撤销。
+         */
+        post: operations["disable-api-key"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/keys/{keyId}/enable": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 启用 API Key
+         * @description 两种情况开不回来：已撤销的（`API_KEY_REVOKED`），以及因项目停服被停的（`API_KEY_PROJECT_SUSPENDED`，响应里 `suspended` 为 true）。后者要等项目恢复。
+         */
+        post: operations["enable-api-key"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/keys/{keyId}/revoke": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 撤销 API Key
+         * @description **不可逆。** 用于这把 key 泄露了的情况——比如被提交进了仓库。
+         *
+         *     记录不删除：这把 key 在被撤销前打了多少请求仍然查得到，那正是出事之后要看的。
+         *
+         *     只是想临时停一下请用停用。
+         */
+        post: operations["revoke-api-key"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/models": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 列出可用模型
+         * @description 已下架（`retired`）的模型不出现在这里，但仍然查得到——见查看单个模型。
+         *
+         *     `context_length` 和 `max_output_tokens` 仅供客户端提示：服务端不据此截断，请求体原样转给上游。
+         */
+        get: operations["list-models"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/models/{modelId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 查看模型
+         * @description 已下架的模型在这里查得到，但转发时会被拒（`MODEL_RETIRED`）——这和「这个模型不存在」是两件事，前者说明它曾经有过。
+         */
+        get: operations["get-model"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/requests": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 列出请求流水
+         * @description 游标翻页，按时间倒序。`next_cursor` 为空表示已经到底。
+         *
+         *     **不返回请求体和响应体**——canopy 一张表都不存它们。排障请提供 `upstream_request_id`。
+         *
+         *     `usage_source` 为 `estimated` 表示上游这次没给用量，那几个数是我们按字符类估的。
+         */
+        get: operations["list-requests"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/requests/{requestId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 查看单条流水 */
+        get: operations["get-request"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/usage/by-api-key": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 按 API Key 看用量
+         * @description 用来回答「哪把 key 在烧钱」。已撤销的 key 仍然出现在这里——它在被撤销前的用量正是要看的东西。
+         */
+        get: operations["list-usage-by-api-key"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/usage/by-model": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 按模型看用量 */
+        get: operations["list-usage-by-model"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/usage/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 用量合计
+         * @description `from` / `to` 必填，跨度不超过 31 天。两者带时区偏移，传 `2026-08-01T00:00:00+08:00` 得到的就是东八区那一刻起算。
+         *
+         *     五档 token 分开给：缓存命中的读取比普通输入便宜一个数量级，合成一个总数就再也拆不开了。
+         */
+        get: operations["get-usage-summary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/usage/timeline": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 用量曲线
+         * @description 从 `from` 起按 `bucket` 切段，最后一段可能不满。段数上限 100。
+         *
+         *     要按本地日切分就把 `from` 传成本地时间的零点（带偏移）、`bucket` 传 `24h`——服务端不猜时区。
+         */
+        get: operations["get-usage-timeline"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        Error: {
+            code?: string;
+            message: string;
+            meta?: {
+                [key: string]: unknown;
+            };
+            /** Format: int64 */
+            status: number;
+        };
+        APIKeyResource: {
+            /** @description restrict_models 为 false 时无意义 */
+            allowed_models: string[];
+            /** Format: date-time */
+            created_at: string;
+            /**
+             * Format: uuid
+             * @description 建这把 key 的人
+             */
+            created_by: string;
+            /**
+             * Format: date-time
+             * @description 到期时间；null 表示永不过期
+             */
+            expires_at: string | null;
+            /** Format: uuid */
+            id: string;
+            /** @description 明文的后四位 */
+            last_four: string;
+            /**
+             * Format: date-time
+             * @description 最后一次成功用它转发的时刻，精度约一分钟
+             */
+            last_used_at: string | null;
+            name: string;
+            /** @description 明文的前几位，用来在列表里辨认 */
+            prefix: string;
+            /** @description true 时只允许 allowed_models 里的模型 */
+            restrict_models: boolean;
+            /** @enum {string} */
+            status: "active" | "disabled" | "revoked";
+            /** @description true 表示这把 key 因项目停服被停，需要项目恢复后才能再用 */
+            suspended: boolean;
+        };
+        LengthAwarePageAPIKeyResource: {
+            /** @description 这一页的内容 */
+            items: components["schemas"]["APIKeyResource"][];
+            /**
+             * Format: int64
+             * @description 这一页最多几条，回显请求里的值
+             */
+            limit: number;
+            /**
+             * Format: int64
+             * @description 跳过了多少条，回显请求里的值
+             */
+            offset: number;
+            /**
+             * Format: int64
+             * @description 命中的总条数，不只是这一页
+             */
+            total: number;
+        };
+        CreateAPIKeyRequestBody: {
+            /** @description restrict_models 为 false 时忽略 */
+            allowed_models?: string[] | null;
+            /**
+             * Format: date-time
+             * @description 到期时间；不填表示永不过期
+             */
+            expires_at?: string | null;
+            /** @description 给自己看的名字，比如「CI」「生产」 */
+            name: string;
+            /** @description true 时只允许 allowed_models 里的模型 */
+            restrict_models?: boolean;
+        };
+        IssuedAPIKeyResource: {
+            /** @description restrict_models 为 false 时无意义 */
+            allowed_models: string[];
+            /** Format: date-time */
+            created_at: string;
+            /**
+             * Format: uuid
+             * @description 建这把 key 的人
+             */
+            created_by: string;
+            /**
+             * Format: date-time
+             * @description 到期时间；null 表示永不过期
+             */
+            expires_at: string | null;
+            /** Format: uuid */
+            id: string;
+            /** @description 明文的后四位 */
+            last_four: string;
+            /**
+             * Format: date-time
+             * @description 最后一次成功用它转发的时刻，精度约一分钟
+             */
+            last_used_at: string | null;
+            name: string;
+            /** @description 明文的前几位，用来在列表里辨认 */
+            prefix: string;
+            /** @description true 时只允许 allowed_models 里的模型 */
+            restrict_models: boolean;
+            /** @description 完整的 key，**只在这一次响应里出现**，请立即保存 */
+            secret: string;
+            /** @enum {string} */
+            status: "active" | "disabled" | "revoked";
+            /** @description true 表示这把 key 因项目停服被停，需要项目恢复后才能再用 */
+            suspended: boolean;
+        };
+        UpdateAPIKeyRequestBody: {
+            allowed_models?: string[] | null;
+            /** @description true 表示改成永不过期 */
+            clear_expiry?: boolean;
+            /**
+             * Format: date-time
+             * @description 改到期时间；要改成永不过期请用 clear_expiry
+             */
+            expires_at?: string | null;
+            name?: string | null;
+            restrict_models?: boolean | null;
+        };
+        ModelResource: {
+            /**
+             * Format: int64
+             * @description 上下文窗口，仅供客户端提示，服务端不据此截断
+             */
+            context_length: number;
+            display_name: string;
+            /** @description 同一系列聚在一起用，如 claude、gpt、gemini */
+            family: string;
+            /** @description 请求体里 model 字段要填的那个字符串 */
+            id: string;
+            /**
+             * Format: int64
+             * @description 最大输出，仅供客户端提示
+             */
+            max_output_tokens: number;
+            /** @description reasoning_effort 能填的值；空表示不支持 */
+            reasoning_tiers: string[];
+            /** @enum {string} */
+            status: "available" | "draining" | "retired";
+            supports_reasoning: boolean;
+            supports_tools: boolean;
+            supports_vision: boolean;
+        };
+        ModelListResponseBody: {
+            items: components["schemas"]["ModelResource"][];
+        };
+        RequestResource: {
+            /** Format: uuid */
+            api_key_id: string;
+            /**
+             * Format: int64
+             * @description 命中上游前缀缓存的部分，比普通输入便宜一个数量级
+             */
+            cache_read_tokens: number;
+            /** Format: int64 */
+            cache_write_tokens: number;
+            /** @description 失败时的错误码；成功时为空 */
+            error_code: string;
+            /** Format: date-time */
+            finished_at: string | null;
+            /** Format: date-time */
+            first_token_at: string | null;
+            /** Format: uuid */
+            id: string;
+            /** Format: int64 */
+            input_tokens: number;
+            /** @description 请求里写的模型名 */
+            model_id: string;
+            /** Format: int64 */
+            output_tokens: number;
+            /** Format: int64 */
+            reasoning_tokens: number;
+            /** Format: int64 */
+            retries: number;
+            /** Format: date-time */
+            started_at: string;
+            /** @enum {string} */
+            status: "in_flight" | "succeeded" | "refused" | "upstream_failed" | "client_aborted";
+            stream: boolean;
+            /** @description 上游那边的请求 id，报障时提供给我们 */
+            upstream_request_id: string;
+            /**
+             * Format: int64
+             * @description 上游返回的 HTTP 状态码；0 表示没打到上游
+             */
+            upstream_status: number;
+            /**
+             * @description upstream 是上游报的，estimated 是我们按字符类估的
+             * @enum {string}
+             */
+            usage_source: "none" | "upstream" | "estimated";
+        };
+        CursorPageRequestResource: {
+            /** @description 这一页的内容 */
+            items: components["schemas"]["RequestResource"][];
+            /** @description 下一页的游标；为空表示已经到底 */
+            next_cursor: string;
+        };
+        APIKeyUsageResource: {
+            /** Format: uuid */
+            api_key_id: string;
+            /** Format: int64 */
+            cache_read_tokens: number;
+            /** Format: int64 */
+            cache_write_tokens: number;
+            /** Format: int64 */
+            input_tokens: number;
+            /** Format: int64 */
+            output_tokens: number;
+            /** Format: int64 */
+            reasoning_tokens: number;
+            /** Format: int64 */
+            requests: number;
+        };
+        APIKeyUsageListResponseBody: {
+            items: components["schemas"]["APIKeyUsageResource"][];
+        };
+        ModelUsageResource: {
+            /** Format: int64 */
+            cache_read_tokens: number;
+            /** Format: int64 */
+            cache_write_tokens: number;
+            /** Format: int64 */
+            input_tokens: number;
+            model_id: string;
+            /** Format: int64 */
+            output_tokens: number;
+            /** Format: int64 */
+            reasoning_tokens: number;
+            /** Format: int64 */
+            requests: number;
+        };
+        ModelUsageListResponseBody: {
+            items: components["schemas"]["ModelUsageResource"][];
+        };
+        TotalsResource: {
+            /** Format: int64 */
+            cache_read_tokens: number;
+            /** Format: int64 */
+            cache_write_tokens: number;
+            /** Format: int64 */
+            input_tokens: number;
+            /** Format: int64 */
+            output_tokens: number;
+            /** Format: int64 */
+            reasoning_tokens: number;
+            /** Format: int64 */
+            requests: number;
+        };
+        UsageBucketResource: {
+            /** Format: int64 */
+            cache_read_tokens: number;
+            /** Format: int64 */
+            cache_write_tokens: number;
+            /**
+             * Format: date-time
+             * @description 这一段的起点，含
+             */
+            from: string;
+            /** Format: int64 */
+            input_tokens: number;
+            /** Format: int64 */
+            output_tokens: number;
+            /** Format: int64 */
+            reasoning_tokens: number;
+            /** Format: int64 */
+            requests: number;
+            /**
+             * Format: date-time
+             * @description 这一段的终点，不含
+             */
+            to: string;
+        };
+        UsageTimelineResponseBody: {
+            items: components["schemas"]["UsageBucketResource"][];
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    "list-api-keys": {
+        parameters: {
+            query?: {
+                /** @description 这一页最多返回多少条 */
+                limit?: number;
+                /** @description 跳过多少条。要翻得更深请改用游标翻页的接口 */
+                offset?: number;
+                /** @description 只看这个状态的；不传表示全部 */
+                status?: "active" | "disabled" | "revoked";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageAPIKeyResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "create-api-key": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateAPIKeyRequestBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IssuedAPIKeyResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-api-key": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                keyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIKeyResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "update-api-key": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                keyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateAPIKeyRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIKeyResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "disable-api-key": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                keyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIKeyResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "enable-api-key": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                keyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIKeyResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "revoke-api-key": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                keyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIKeyResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-models": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ModelListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-model": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                modelId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ModelResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-requests": {
+        parameters: {
+            query: {
+                /** @description 起点，含。RFC 3339，带时区偏移 */
+                from: string;
+                /** @description 终点，不含。RFC 3339，带时区偏移 */
+                to: string;
+                /** @description 只看这个模型 */
+                model_id?: string;
+                /** @description 只看这把 key */
+                api_key_id?: string;
+                /** @description 只看这个状态的 */
+                status?: "in_flight" | "succeeded" | "refused" | "upstream_failed" | "client_aborted";
+                /** @description 这一页最多返回多少条 */
+                limit?: number;
+                /** @description 上一页返回的 next_cursor；首页不填 */
+                cursor?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CursorPageRequestResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-request": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                requestId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RequestResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-usage-by-api-key": {
+        parameters: {
+            query: {
+                /** @description 起点，含。RFC 3339，带时区偏移 */
+                from: string;
+                /** @description 终点，不含。RFC 3339，带时区偏移 */
+                to: string;
+                /** @description 只看这个模型 */
+                model_id?: string;
+                /** @description 只看这把 key */
+                api_key_id?: string;
+                /** @description 只看这个状态的 */
+                status?: "in_flight" | "succeeded" | "refused" | "upstream_failed" | "client_aborted";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIKeyUsageListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-usage-by-model": {
+        parameters: {
+            query: {
+                /** @description 起点，含。RFC 3339，带时区偏移 */
+                from: string;
+                /** @description 终点，不含。RFC 3339，带时区偏移 */
+                to: string;
+                /** @description 只看这个模型 */
+                model_id?: string;
+                /** @description 只看这把 key */
+                api_key_id?: string;
+                /** @description 只看这个状态的 */
+                status?: "in_flight" | "succeeded" | "refused" | "upstream_failed" | "client_aborted";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ModelUsageListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-usage-summary": {
+        parameters: {
+            query: {
+                /** @description 起点，含。RFC 3339，带时区偏移 */
+                from: string;
+                /** @description 终点，不含。RFC 3339，带时区偏移 */
+                to: string;
+                /** @description 只看这个模型 */
+                model_id?: string;
+                /** @description 只看这把 key */
+                api_key_id?: string;
+                /** @description 只看这个状态的 */
+                status?: "in_flight" | "succeeded" | "refused" | "upstream_failed" | "client_aborted";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TotalsResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-usage-timeline": {
+        parameters: {
+            query: {
+                /** @description 起点，含。RFC 3339，带时区偏移 */
+                from: string;
+                /** @description 终点，不含。RFC 3339，带时区偏移 */
+                to: string;
+                /** @description 只看这个模型 */
+                model_id?: string;
+                /** @description 只看这把 key */
+                api_key_id?: string;
+                /** @description 只看这个状态的 */
+                status?: "in_flight" | "succeeded" | "refused" | "upstream_failed" | "client_aborted";
+                /** @description 每段多长，Go 的时长写法，如 1h、24h。段数上限 100 */
+                bucket?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UsageTimelineResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+}