@huyooo/ui 0.13.6 → 0.13.8

package/dist/types/api/billing.generated.d.ts

@@ -1,4 +1,4 @@
-import { ApiResponse, RequestConfig, Client, EdenClient } from '@vafast/api-client';
+import { RequestConfig, Client, EdenClient, RequestBuilder } from '@vafast/api-client';
 /** API 契约类型 */
 export type Api = {
     health: {
@@ -287,6 +287,24 @@ export type Api = {
                 return: any;
             };
         };
+        historyFind: {
+            /** 分页查询订阅权益变化历史（管理端） */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        userId?: string;
+                        subscriptionId?: string;
+                        productId?: string;
+                        action?: string;
+                        startTime?: string;
+                        endTime?: string;
+                    };
+                };
+                return: any;
+            };
+        };
         trend: {
             /** 获取订阅各状态的历史趋势数据 */
             post: {
@@ -734,7 +752,8 @@ export type Api = {
             post: {
                 body: {
                     userId: string;
-                    amount: number;
+                    amount?: number;
+                    amountMicro?: number;
                     requestId?: string;
                     description?: string;
                     metadata?: Record<string, unknown>;
@@ -1317,7 +1336,7 @@ export type Api = {
     };
     consumption: {
         trend: {
-            /** 聚合服务消费的趋势数据 */
+            /** 聚合积分消耗趋势 */
             post: {
                 body: {
                     startDate?: string;
@@ -1328,7 +1347,7 @@ export type Api = {
             };
         };
         overview: {
-            /** 聚合服务消费的概览数据 */
+            /** 聚合积分消耗概览 */
             post: {
                 body: {
                     startDate?: string;
@@ -1338,6 +1357,80 @@ export type Api = {
             };
         };
     };
+    billingUsage: {
+        charges: {
+            list: {
+                /** 查询 billingUsageRecord 全站扣费流水 */
+                post: {
+                    body: {
+                        page?: number;
+                        pageSize?: number;
+                        userId?: string;
+                        serviceGroup?: "ai" | "platform" | "storage";
+                        serviceKey?: string;
+                        chargeMethodKey?: string;
+                        subjectKey?: string;
+                        id?: string;
+                        idempotencyKey?: string;
+                        resourceId?: string;
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                    return: any;
+                };
+            };
+            get: {
+                /** 按 ID 查询单条扣费记录（含 AI 扩展字段，供详情抽屉） */
+                post: {
+                    body: {
+                        id: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        consumption: {
+            overview: {
+                /** 聚合 AI / 平台 / 存储积分消耗 */
+                post: {
+                    body: {
+                        userId?: string;
+                        serviceGroup?: "ai" | "platform" | "storage";
+                        serviceKey?: string;
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                    return: any;
+                };
+            };
+            trend: {
+                /** 按日聚合积分消耗趋势 */
+                post: {
+                    body: {
+                        userId?: string;
+                        serviceGroup?: "ai" | "platform" | "storage";
+                        serviceKey?: string;
+                        startDate?: string;
+                        endDate?: string;
+                        limit?: number;
+                    };
+                    return: any;
+                };
+            };
+        };
+        reference: {
+            trace: {
+                /** 按 resourceId 查询扣费明细与积分流水 */
+                post: {
+                    body: {
+                        resourceId: string;
+                        serviceKey?: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+    };
     pointsRecharge: {
         packages: {
             /** 获取可用的充值套餐列表 */
@@ -1619,6 +1712,8 @@ export type Api = {
                 body: {
                     page?: number;
                     pageSize?: number;
+                    keyword?: string;
+                    enabled?: boolean;
                 };
                 return: any;
             };
@@ -1630,8 +1725,6 @@ export type Api = {
                     serviceType: string;
                     name: string;
                     description?: string;
-                    billingUnit: string;
-                    billingMode?: "event" | "continuous";
                 };
                 return: any;
             };
@@ -1643,8 +1736,6 @@ export type Api = {
                     id: string;
                     name?: string;
                     description?: string;
-                    billingUnit?: string;
-                    billingMode?: "event" | "continuous";
                     enabled?: boolean;
                 };
                 return: any;
@@ -1660,43 +1751,16 @@ export type Api = {
             };
         };
     };
-    pricingRule: {
-        get: {
-            /** 获取服务的定价规则 */
-            post: {
-                body: {
-                    serviceType: string;
-                };
-                return: any;
-            };
-        };
-        save: {
-            /** 创建或更新定价规则 */
-            post: {
-                body: {
-                    serviceType: string;
-                    tiers?: {
-                        minUsage: number;
-                        maxUsage: number | null;
-                        pricePerUnit: number;
-                    }[];
-                    flatPrice?: number | null;
-                    freeQuota?: number;
-                    profitMargin?: number;
-                    enabled?: boolean;
-                };
-                return: any;
-            };
-        };
-    };
     usage: {
         report: {
             /** 上报服务用量，自动计费扣费 */
             post: {
                 body: {
                     serviceType: string;
+                    chargeMethodKey?: string;
                     metadata: Record<string, unknown>;
-                    requestId?: string;
+                    idempotencyKey?: string;
+                    resourceId?: string;
                 };
                 return: any;
             };
@@ -1706,6 +1770,7 @@ export type Api = {
             post: {
                 body: {
                     serviceType: string;
+                    chargeMethodKey?: string;
                     metadata: Record<string, unknown>;
                     freeQuotaOverride?: number;
                 };
@@ -1719,6 +1784,7 @@ export type Api = {
                     startDate?: string;
                     endDate?: string;
                     serviceType?: string;
+                    userId?: string;
                     groupBy?: "day" | "service" | "user";
                 };
                 return: any;
@@ -1730,7 +1796,12 @@ export type Api = {
                 body: {
                     page?: number;
                     pageSize?: number;
-                    serviceType?: string;
+                    id?: string;
+                    idempotencyKey?: string;
+                    resourceId?: string;
+                    serviceKey?: string;
+                    chargeMethodKey?: string;
+                    userId?: string;
                     startDate?: string;
                     endDate?: string;
                 };
@@ -1738,6 +1809,291 @@ export type Api = {
             };
         };
     };
+    servicePricing: {
+        overview: {
+            post: {
+                return: any;
+            };
+        };
+        list: {
+            post: {
+                body: {
+                    serviceKey?: string;
+                };
+                return: any;
+            };
+        };
+        get: {
+            post: {
+                body: {
+                    serviceKey: string;
+                    chargeMethodKey: string;
+                };
+                return: any;
+            };
+        };
+        upsert: {
+            post: {
+                body: {
+                    serviceKey: string;
+                    chargeMethodKey: string;
+                    originalPrice: number;
+                    sellPrice: number;
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        importLegacy: {
+            /** 幂等：将旧 pricingRule 导入 billingServicePricing */
+            post: {
+                return: any;
+            };
+        };
+    };
+    priceList: {
+        list: {
+            post: {
+                body: {
+                    serviceKey?: string;
+                    chargeMethodKey?: string;
+                    pricingType?: "flat" | "tiered" | "dimensions";
+                    enabled?: boolean;
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        get: {
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        create: {
+            post: {
+                body: {
+                    serviceKey: string;
+                    chargeMethodKey: string;
+                    name: string;
+                    currency?: "CNY" | "USD";
+                    enabled?: boolean;
+                    pricing: {
+                        type: "flat";
+                        originalPrice: number;
+                        sellPrice: number;
+                    } | {
+                        type: "tiered";
+                        priceStructure: "flat" | "segmented";
+                        tiers: {
+                            tierKey?: string;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                            originalFenPerUnit: number;
+                            sellFenPerUnit: number;
+                            billingEnabled: boolean;
+                        }[];
+                    } | {
+                        type: "dimensions";
+                        dimensions: {
+                            dimensionKey: string;
+                            unit: string;
+                            priceStructure?: "flat" | "segmented";
+                            tiers: {
+                                tierKey?: string;
+                                tierRangeMode?: "at_most" | "at_least" | "between";
+                                minTokens?: number;
+                                maxTokens?: number;
+                                minInclusive?: boolean;
+                                maxInclusive?: boolean;
+                                minOutputTokens?: number;
+                                maxOutputTokens?: number;
+                                originalFenPerUnit: number;
+                                sellFenPerUnit: number;
+                                billingEnabled: boolean;
+                            }[];
+                        }[];
+                    };
+                };
+                return: any;
+            };
+        };
+        update: {
+            post: {
+                body: {
+                    id: string;
+                    name?: string;
+                    currency?: "CNY" | "USD";
+                    enabled?: boolean;
+                    pricing?: {
+                        type: "flat";
+                        originalPrice: number;
+                        sellPrice: number;
+                    } | {
+                        type: "tiered";
+                        priceStructure: "flat" | "segmented";
+                        tiers: {
+                            tierKey?: string;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                            originalFenPerUnit: number;
+                            sellFenPerUnit: number;
+                            billingEnabled: boolean;
+                        }[];
+                    } | {
+                        type: "dimensions";
+                        dimensions: {
+                            dimensionKey: string;
+                            unit: string;
+                            priceStructure?: "flat" | "segmented";
+                            tiers: {
+                                tierKey?: string;
+                                tierRangeMode?: "at_most" | "at_least" | "between";
+                                minTokens?: number;
+                                maxTokens?: number;
+                                minInclusive?: boolean;
+                                maxInclusive?: boolean;
+                                minOutputTokens?: number;
+                                maxOutputTokens?: number;
+                                originalFenPerUnit: number;
+                                sellFenPerUnit: number;
+                                billingEnabled: boolean;
+                            }[];
+                        }[];
+                    };
+                };
+                return: any;
+            };
+        };
+        delete: {
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+    };
+    priceBinding: {
+        list: {
+            post: {
+                body: {
+                    subjectType?: "model-profile";
+                    subjectKey?: string;
+                    serviceKey?: string;
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        upsert: {
+            post: {
+                body: {
+                    subjectType: "model-profile";
+                    subjectKey: string;
+                    priceListId: string;
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+    };
+    billingMethodDefinition: {
+        list: {
+            post: {
+                body: {
+                    serviceKey?: string;
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        get: {
+            post: {
+                body: {
+                    chargeMethodKey: string;
+                };
+                return: any;
+            };
+        };
+        create: {
+            post: {
+                body: {
+                    serviceKey: string;
+                    chargeMethodKey: string;
+                    label: string;
+                    billingUnit: string;
+                    chargeKind: "instant" | "settlement";
+                    settlementPeriod?: "second" | "minute" | "hour" | "day" | "month";
+                    priceStructure?: "flat" | "segmented";
+                    tiers?: {
+                        tierKey?: string;
+                        tierRangeMode?: "at_most" | "at_least" | "between";
+                        minTokens?: number;
+                        maxTokens?: number;
+                        minInclusive?: boolean;
+                        maxInclusive?: boolean;
+                        originalFenPerUnit: number;
+                        sellFenPerUnit: number;
+                        billingEnabled: boolean;
+                    }[];
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        update: {
+            post: {
+                body: {
+                    id: string;
+                    label?: string;
+                    billingUnit?: string;
+                    chargeKind?: "instant" | "settlement";
+                    settlementPeriod?: "second" | "minute" | "hour" | "day" | "month";
+                    priceStructure?: "flat" | "segmented";
+                    tiers?: {
+                        tierKey?: string;
+                        tierRangeMode?: "at_most" | "at_least" | "between";
+                        minTokens?: number;
+                        maxTokens?: number;
+                        minInclusive?: boolean;
+                        maxInclusive?: boolean;
+                        originalFenPerUnit: number;
+                        sellFenPerUnit: number;
+                        billingEnabled: boolean;
+                    }[];
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+    };
     export: {
         recharge: {
             /** 导出充值订单记录为 CSV 格式 */
@@ -2044,7 +2400,8 @@ export type Api = {
                     body: {
                         appId: string;
                         userId: string;
-                        serviceType: string;
+                        serviceKey: string;
+                        chargeMethodKey: string;
                         amount: number;
                         freeQuotaOverride?: number;
                     };
@@ -2059,7 +2416,8 @@ export type Api = {
                         items: {
                             key: string;
                             userId: string;
-                            serviceType: string;
+                            serviceKey: string;
+                            chargeMethodKey: string;
                             amount: number;
                             freeQuotaOverride?: number;
                         }[];
@@ -2073,10 +2431,12 @@ export type Api = {
                     body: {
                         appId: string;
                         userId: string;
-                        serviceType: string;
+                        serviceKey: string;
+                        chargeMethodKey: string;
                         amount: number;
                         metadata?: Record<string, unknown>;
-                        requestId?: string;
+                        idempotencyKey?: string;
+                        resourceId?: string;
                         usageKind?: "event" | "continuous_settlement";
                         periodStart?: string;
                         periodEnd?: string;
@@ -2085,18 +2445,172 @@ export type Api = {
                     return: any;
                 };
             };
-        };
-    };
-    webhooks: {
-        events: {
-            /** 获取所有可用的 Webhook 事件类型 */
-            get: {
-                return: any;
-            };
-            ':id': {
-                /** 获取指定分类的 Webhook 事件 */
-                get: {
-                    params: {
+            reversal: {
+                /** 供内部服务冲正已上报的服务用量并退还积分 */
+                post: {
+                    body: {
+                        appId: string;
+                        userId: string;
+                        idempotencyKey: string;
+                        reason?: string;
+                        reversalIdempotencyKey?: string;
+                    };
+                    return: any;
+                };
+            };
+            'record-ai': {
+                /** 供 ai-server 计价后写入统一用量账本并扣积分 */
+                post: {
+                    body: {
+                        appId: string;
+                        userId: string;
+                        idempotencyKey: string;
+                        serviceKey: string;
+                        chargeMethodKey: string;
+                        resourceId?: string;
+                        subjectKey: string;
+                        labels?: Record<string, string>;
+                        pointsConsumed: number;
+                        quantity?: number;
+                        unit?: string;
+                        snapshot?: {
+                            priceListId?: string;
+                            usage?: Record<string, number>;
+                            cost?: Record<string, unknown>;
+                        };
+                    };
+                    return: any;
+                };
+            };
+            list: {
+                /** 供 ai-server 等内部服务查询 billingUsageRecord */
+                post: {
+                    body: {
+                        appId: string;
+                        userId?: string;
+                        serviceGroup?: "ai" | "platform" | "storage";
+                        serviceGroups?: "ai" | "platform" | "storage"[];
+                        referenceId?: string;
+                        serviceKey?: string;
+                        chargeMethodKey?: string;
+                        model?: string;
+                        subjectKeys?: string[];
+                        id?: string;
+                        requestId?: string;
+                        startTime?: string;
+                        endTime?: string;
+                        page?: number;
+                        pageSize?: number;
+                    };
+                    return: any;
+                };
+            };
+            'stats-ai': {
+                /** 供 ai-server 查询 AI 用量聚合统计 */
+                post: {
+                    body: {
+                        appId: string;
+                        userId?: string;
+                        subjectKeys?: string[];
+                        startTime?: string;
+                        endTime?: string;
+                        timezone?: string;
+                    };
+                    return: any;
+                };
+            };
+            'by-reference': {
+                /** 按 referenceId 联合查询用量与积分流水 */
+                post: {
+                    body: {
+                        appId: string;
+                        referenceId: string;
+                        serviceKey?: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        pricing: {
+            'resolve-model': {
+                /** 供 ai-server 运行时读取模型定价 */
+                post: {
+                    body: {
+                        appId: string;
+                        supplierId: string;
+                        profileId: string;
+                        productLine?: string;
+                        billingPlan?: string;
+                    };
+                    return: any;
+                };
+            };
+            'sync-model': {
+                post: {
+                    body: {
+                        appId: string;
+                        operatorId: string;
+                        supplierId: string;
+                        profileId: string;
+                        productLine: string;
+                        currency: "CNY" | "USD";
+                        plans: unknown[];
+                    };
+                    return: any;
+                };
+            };
+            'delete-model': {
+                post: {
+                    body: {
+                        appId: string;
+                        supplierId: string;
+                        profileId: string;
+                    };
+                    return: any;
+                };
+            };
+            'load-model-plans': {
+                post: {
+                    body: {
+                        appId: string;
+                        supplierId: string;
+                        profileId: string;
+                    };
+                    return: any;
+                };
+            };
+            'list-model-pricing-map': {
+                post: {
+                    body: {
+                        appId: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        points: {
+            'by-request-ids': {
+                /** 供 ai-server 溯源：通过 requestId 列表查询 pointsHistory */
+                post: {
+                    body: {
+                        appId: string;
+                        requestIds: string[];
+                    };
+                    return: any;
+                };
+            };
+        };
+    };
+    webhooks: {
+        events: {
+            /** 获取所有可用的 Webhook 事件类型 */
+            get: {
+                return: any;
+            };
+            ':id': {
+                /** 获取指定分类的 Webhook 事件 */
+                get: {
+                    params: {
                         category: string;
                     };
                     return: any;
@@ -2114,11 +2628,11 @@ export type Api = {
 /** API 客户端类型（提供完整的 IDE 智能提示） */
 export interface ApiClient {
     health: {
-        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        get: (config?: RequestConfig) => RequestBuilder<any>;
     };
     'api-spec': {
         /** 获取 API 规范，用于类型同步 */
-        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        get: (config?: RequestConfig) => RequestBuilder<any>;
     };
     products: {
         create: {
@@ -2136,13 +2650,13 @@ export interface ApiClient {
                 }[];
                 metadata?: Record<string, unknown>;
                 displayOrder?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除产品 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新产品信息 */
@@ -2161,7 +2675,7 @@ export interface ApiClient {
                 status?: "active" | "archived";
                 metadata?: Record<string, unknown>;
                 displayOrder?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询产品列表 */
@@ -2172,13 +2686,13 @@ export interface ApiClient {
                     name?: string;
                     status?: "" | "active" | "archived";
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询产品详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         updateSort: {
             /** 批量更新产品排序 */
@@ -2187,11 +2701,11 @@ export interface ApiClient {
                     id: string;
                     displayOrder: number;
                 }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         listActive: {
             /** 获取定价页面可用产品列表（公开） */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     prices: {
@@ -2208,13 +2722,13 @@ export interface ApiClient {
                 interval?: "day" | "week" | "month" | "year";
                 intervalCount?: number;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除价格方案 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新价格方案信息 */
@@ -2225,7 +2739,7 @@ export interface ApiClient {
                 metadata?: Record<string, unknown>;
                 trialPeriodDays?: number;
                 allowRepeatTrial?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询价格方案列表 */
@@ -2237,23 +2751,23 @@ export interface ApiClient {
                     type?: "" | "free" | "one_time" | "recurring";
                     active?: boolean;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询价格方案详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         listByProduct: {
             /** 获取指定产品的所有可用价格方案 */
             post: (body: {
                 productId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         listFreeActive: {
             /** 获取当前应用可领取的免费体验价格方案 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     subscriptions: {
@@ -2262,7 +2776,7 @@ export interface ApiClient {
             post: (body: {
                 priceId: string;
                 couponCode?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         cancel: {
             /** 取消订阅 */
@@ -2270,13 +2784,13 @@ export interface ApiClient {
                 subscriptionId: string;
                 cancelAtPeriodEnd?: boolean;
                 reason?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         resume: {
             /** 恢复已取消的订阅 */
             post: (body: {
                 subscriptionId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         change: {
             /** 升级或降级订阅 */
@@ -2284,7 +2798,7 @@ export interface ApiClient {
                 subscriptionId: string;
                 newPriceId: string;
                 proration?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         my: {
             /** 查询当前用户的订阅列表 */
@@ -2292,21 +2806,21 @@ export interface ApiClient {
                 current?: number;
                 pageSize?: number;
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         current: {
             /** 获取当前活跃订阅 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         summary: {
             /** 获取当前用户订阅、配额、积分和待支付账单摘要 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         userDetail: {
             /** 管理员查询指定用户的订阅、免费体验、配额、积分和最近消费记录 */
             post: (body: {
                 userId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询订阅列表（管理端） */
@@ -2319,13 +2833,28 @@ export interface ApiClient {
                     status?: string;
                     cancelAtPeriodEnd?: boolean;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         history: {
             /** 查询单个订阅的权益变化历史（管理端） */
             post: (body: {
                 subscriptionId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        historyFind: {
+            /** 分页查询订阅权益变化历史（管理端） */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    userId?: string;
+                    subscriptionId?: string;
+                    productId?: string;
+                    action?: string;
+                    startTime?: string;
+                    endTime?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         trend: {
             /** 获取订阅各状态的历史趋势数据 */
@@ -2333,26 +2862,26 @@ export interface ApiClient {
                 startTime: string;
                 endTime: string;
                 granularity: "day" | "week" | "month";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         count: {
             /** 供其他服务查询用户订阅数量 */
             post: (body: {
                 userId: string;
                 appId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         countBatch: {
             /** 供其他服务批量查询用户订阅数量 */
             post: (body: {
                 userIds: string[];
                 appId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         notify: {
             alipay: {
                 /** 支付宝订阅支付回调通知 */
-                post: (body: Record<string, unknown>, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
@@ -2367,13 +2896,13 @@ export interface ApiClient {
                 limit: number;
                 period: "day" | "week" | "month" | "year" | "lifetime";
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除配额定义 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新配额定义 */
@@ -2384,7 +2913,7 @@ export interface ApiClient {
                 limit?: number;
                 period?: "day" | "week" | "month" | "year" | "lifetime";
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询配额列表 */
@@ -2396,7 +2925,7 @@ export interface ApiClient {
                     priceId?: string;
                     featureKey?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         check: {
             /** 供其他服务检查配额是否足够，不写入使用量 */
@@ -2406,11 +2935,11 @@ export interface ApiClient {
                 featureKey: string;
                 quantity?: number;
                 used?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         my: {
             /** 获取当前用户的配额使用情况 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         reserve: {
             /** 供其他服务检查并预占配额 */
@@ -2420,51 +2949,51 @@ export interface ApiClient {
                 featureKey: string;
                 quantity?: number;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         commit: {
             /** 供其他服务确认已预占配额 */
             post: (body: {
                 usageRecordId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         release: {
             /** 供其他服务释放已预占配额 */
             post: (body: {
                 usageRecordId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     trials: {
         current: {
             /** 获取当前用户免费体验状态 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         start: {
             /** 领取当前应用的免费体验权益 */
             post: (body: {
                 priceId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     newUserDefaults: {
         find: {
             /** 查询注册后默认授予的免费权益配置 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新注册后默认授予的免费权益配置 */
             post: (body: {
                 autoGrantFreePriceOnSignup: boolean;
                 defaultFreePriceId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         grantMissingFreeEntitlements: {
             /** 给当前应用下没有活跃订阅/体验的用户补发默认免费价格方案 */
             post: (body: {
                 dryRun?: boolean;
                 userIds?: string[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     usageRecords: {
@@ -2475,7 +3004,7 @@ export interface ApiClient {
                 featureKey: string;
                 quantity?: number;
                 used?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         reserveQuota: {
             /** 检查配额并写入 reserved 使用量记录 */
@@ -2484,19 +3013,19 @@ export interface ApiClient {
                 featureKey: string;
                 quantity?: number;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         commitQuota: {
             /** 将 reserved 使用量记录确认成 committed */
             post: (body: {
                 usageRecordId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         releaseQuota: {
             /** 将 reserved 使用量记录释放成 released */
             post: (body: {
                 usageRecordId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询使用记录（管理端） */
@@ -2510,7 +3039,7 @@ export interface ApiClient {
                     startTime?: string;
                     endTime?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         my: {
             /** 查询当前用户的使用记录 */
@@ -2521,7 +3050,7 @@ export interface ApiClient {
                 status?: string;
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取使用量统计数据 */
@@ -2531,7 +3060,7 @@ export interface ApiClient {
                 startTime: string;
                 endTime: string;
                 granularity: "hour" | "day" | "week" | "month";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     invoices: {
@@ -2547,13 +3076,13 @@ export interface ApiClient {
                     startTime?: string;
                     endTime?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询订阅账单详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         my: {
             /** 查询当前用户的订阅账单列表 */
@@ -2561,40 +3090,40 @@ export interface ApiClient {
                 current?: number;
                 pageSize?: number;
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         cancel: {
             /** 取消当前用户自己的待支付订阅账单 */
             post: (body: {
                 id: string;
                 reason?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         pay: {
             /** 为当前用户的待支付账单生成支付链接 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         verifyPayment: {
             /** 查询支付宝订单状态，如果已支付则完成订阅入账 */
             post: (body: {
                 orderId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         void: {
             /** 管理端作废待支付订阅账单 */
             post: (body: {
                 id: string;
                 reason?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取订阅账单统计数据 */
             post: (body: {
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         revenueReport: {
             /** 获取收入报表数据 */
@@ -2602,18 +3131,18 @@ export interface ApiClient {
                 startTime: string;
                 endTime: string;
                 granularity: "day" | "week" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         revenueByProduct: {
             /** 获取按产品分布的收入数据 */
             post: (body: {
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statusOptions: {
             /** 获取订阅账单状态下拉选项与展示文案 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         stats: {
             /** 供其他服务查询发票统计数据 */
@@ -2621,7 +3150,7 @@ export interface ApiClient {
                 appId: string;
                 userIds: string[];
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statsByUser: {
             /** 供其他服务按用户分组查询发票统计 */
@@ -2629,7 +3158,7 @@ export interface ApiClient {
                 appId: string;
                 userIds: string[];
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     points: {
@@ -2637,7 +3166,7 @@ export interface ApiClient {
             /** 查询用户积分账户余额 */
             post: (body: {
                 userId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         earn: {
             /** 发放积分（充值、奖励等） */
@@ -2651,17 +3180,18 @@ export interface ApiClient {
                 referrerId?: string;
                 ruleId?: string;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         consume: {
             /** 按调用方计算好的积分数消费积分 */
             post: (body: {
                 userId: string;
-                amount: number;
+                amount?: number;
+                amountMicro?: number;
                 requestId?: string;
                 description?: string;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         consumeByPrice: {
             /** 根据计价配置消费积分 */
@@ -2672,7 +3202,7 @@ export interface ApiClient {
                 requestId?: string;
                 description?: string;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         checkBalance: {
             /** 检查积分是否足够（不扣费） */
@@ -2680,7 +3210,7 @@ export interface ApiClient {
                 userId: string;
                 priceCode: string;
                 quantity?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         reversal: {
             /** 冲正/退还已消费的积分 */
@@ -2689,7 +3219,7 @@ export interface ApiClient {
                 originalTransactionId: string;
                 requestId?: string;
                 reason: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         clawback: {
             /** 追回/扣回已发放的积分 */
@@ -2698,7 +3228,7 @@ export interface ApiClient {
                 originalTransactionId: string;
                 requestId?: string;
                 reason: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         adjust: {
             /** 人工调整积分（加/减） */
@@ -2708,7 +3238,7 @@ export interface ApiClient {
                 requestId?: string;
                 reason: string;
                 relatedOrderId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         batchAdjust: {
             /** 批量调整多用户积分 */
@@ -2717,19 +3247,19 @@ export interface ApiClient {
                 amount: number;
                 requestId?: string;
                 reason: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取用户积分统计数据 */
             post: (body: {
                 userId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         leaderboard: {
             /** 获取积分排行榜 */
             post: (body: {
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsHistory: {
@@ -2743,20 +3273,20 @@ export interface ApiClient {
                 pageSize?: number;
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询积分历史详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取积分统计数据 */
             post: (body: {
                 userId?: string;
                 period?: "day" | "week" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         getTrendChart: {
             /** 获取积分变动趋势图表数据 */
@@ -2765,7 +3295,7 @@ export interface ApiClient {
                 startTime: string;
                 endTime: string;
                 granularity: "minute" | "hour" | "day" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         getTypeDistributionChart: {
             /** 获取积分类型分布图表数据 */
@@ -2773,7 +3303,7 @@ export interface ApiClient {
                 userId?: string;
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         getRankingChart: {
             /** 获取用户积分排行榜 */
@@ -2782,7 +3312,7 @@ export interface ApiClient {
                 startTime?: string;
                 endTime?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsTrigger: {
@@ -2791,7 +3321,7 @@ export interface ApiClient {
             post: (body: {
                 ruleId: string;
                 eventData?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         triggerByEvent: {
             /** 根据事件自动匹配并触发积分规则 */
@@ -2799,7 +3329,7 @@ export interface ApiClient {
                 event: string;
                 eventData?: Record<string, unknown>;
                 userId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         batchTrigger: {
             /** 批量触发多个积分规则 */
@@ -2808,7 +3338,7 @@ export interface ApiClient {
                     ruleId: string;
                     eventData?: Record<string, unknown>;
                 }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsTriggerHistory: {
@@ -2827,21 +3357,21 @@ export interface ApiClient {
                     startDate?: string;
                     endDate?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询积分触发历史详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statusOptions: {
             /** 获取积分触发状态下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         rewardTargetOptions: {
             /** 获取奖励目标下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取积分触发历史统计数据 */
@@ -2851,7 +3381,7 @@ export interface ApiClient {
                 startTime?: string;
                 endTime?: string;
                 period?: "today" | "week" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         trends: {
             /** 获取积分触发趋势图表数据 */
@@ -2861,7 +3391,7 @@ export interface ApiClient {
                 startTime?: string;
                 endTime?: string;
                 granularity?: "minute" | "hour" | "day" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         pointsTrends: {
             /** 获取积分变动趋势图表数据 */
@@ -2871,7 +3401,7 @@ export interface ApiClient {
                 startTime?: string;
                 endTime?: string;
                 granularity?: "minute" | "hour" | "day" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         completionAnalysis: {
             /** 获取积分规则完成度分析数据 */
@@ -2880,7 +3410,7 @@ export interface ApiClient {
                 ruleId?: string;
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         triggerTypeTrends: {
             /** 获取积分触发类型趋势图表数据 */
@@ -2890,7 +3420,7 @@ export interface ApiClient {
                 startTime?: string;
                 endTime?: string;
                 granularity?: "minute" | "hour" | "day" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsTriggerRule: {
@@ -2905,7 +3435,7 @@ export interface ApiClient {
                 pointsReward: unknown;
                 constraints: unknown;
                 activeTimeRanges: unknown;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询积分触发规则列表 */
@@ -2919,13 +3449,13 @@ export interface ApiClient {
                     ruleCode?: string;
                     event?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询积分触发规则详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新积分触发规则配置 */
@@ -2939,28 +3469,28 @@ export interface ApiClient {
                 pointsReward?: unknown;
                 constraints?: unknown;
                 activeTimeRanges?: unknown;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         updateStatus: {
             /** 启用或禁用积分触发规则 */
             post: (body: {
                 id: string;
                 status: "draft" | "active" | "inactive";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除积分触发规则 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statusOptions: {
             /** 获取积分触发规则状态下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         eventOptions: {
             /** 获取可绑定的事件类型选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsPriceConfig: {
@@ -2975,7 +3505,7 @@ export interface ApiClient {
                 unit?: string;
                 minCharge?: number;
                 status?: "active" | "inactive";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询计价配置列表 */
@@ -2988,14 +3518,14 @@ export interface ApiClient {
                 };
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 或 code 查询计价配置详情 */
             post: (body: {
                 id?: string;
                 code?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新计价配置 */
@@ -3008,24 +3538,24 @@ export interface ApiClient {
                 unit?: string;
                 minCharge?: number;
                 status?: "active" | "inactive";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         updateStatus: {
             /** 启用或停用计价配置 */
             post: (body: {
                 id: string;
                 status: "active" | "inactive";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除计价配置 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         billingModeOptions: {
             /** 获取计费方式下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsUsageRecord: {
@@ -3042,7 +3572,7 @@ export interface ApiClient {
                 };
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 按维度统计消费数据 */
@@ -3053,14 +3583,14 @@ export interface ApiClient {
                 priceCode?: string;
                 userId?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         overview: {
             /** 获取消费概览数据 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsBalanceAlert: {
@@ -3072,11 +3602,11 @@ export interface ApiClient {
                 notifyEmail?: boolean;
                 notifyEmails?: string[];
                 cooldownHours?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         getConfig: {
             /** 获取当前预警配置 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         findAlerts: {
             /** 分页查询预警记录 */
@@ -3089,49 +3619,108 @@ export interface ApiClient {
                 };
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         triggerCheck: {
             /** 手动触发预警检查（测试用） */
             post: (body: {
                 userId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     consumption: {
         trend: {
-            /** 聚合服务消费的趋势数据 */
+            /** 聚合积分消耗趋势 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         overview: {
-            /** 聚合服务消费的概览数据 */
+            /** 聚合积分消耗概览 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    billingUsage: {
+        charges: {
+            list: {
+                /** 查询 billingUsageRecord 全站扣费流水 */
+                post: (body: {
+                    page?: number;
+                    pageSize?: number;
+                    userId?: string;
+                    serviceGroup?: "ai" | "platform" | "storage";
+                    serviceKey?: string;
+                    chargeMethodKey?: string;
+                    subjectKey?: string;
+                    id?: string;
+                    idempotencyKey?: string;
+                    resourceId?: string;
+                    startDate?: string;
+                    endDate?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            get: {
+                /** 按 ID 查询单条扣费记录（含 AI 扩展字段，供详情抽屉） */
+                post: (body: {
+                    id: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        consumption: {
+            overview: {
+                /** 聚合 AI / 平台 / 存储积分消耗 */
+                post: (body: {
+                    userId?: string;
+                    serviceGroup?: "ai" | "platform" | "storage";
+                    serviceKey?: string;
+                    startDate?: string;
+                    endDate?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            trend: {
+                /** 按日聚合积分消耗趋势 */
+                post: (body: {
+                    userId?: string;
+                    serviceGroup?: "ai" | "platform" | "storage";
+                    serviceKey?: string;
+                    startDate?: string;
+                    endDate?: string;
+                    limit?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        reference: {
+            trace: {
+                /** 按 resourceId 查询扣费明细与积分流水 */
+                post: (body: {
+                    resourceId: string;
+                    serviceKey?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
         };
     };
     pointsRecharge: {
         packages: {
             /** 获取可用的充值套餐列表 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         createOrder: {
             /** 创建积分充值订单 */
             post: (body: {
                 packageId: string;
                 payType: "alipay" | "weixinpay";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         createQRCodeOrder: {
             /** 创建支付宝扫码支付订单（当面付） */
             post: (body: {
                 packageId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         orders: {
             /** 查询用户的充值订单记录 */
@@ -3139,7 +3728,7 @@ export interface ApiClient {
                 status?: string;
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 管理端分页查询全部积分充值订单 */
@@ -3152,42 +3741,42 @@ export interface ApiClient {
                     startTime?: string;
                     endTime?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         detail: {
             /** 管理端查询单个积分充值订单详情及操作时间线 */
             post: (body: {
                 orderId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         adminStatistics: {
             /** 管理端积分充值订单统计 */
             post: (body: {
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取用户积分充值订单统计 */
             post: (body: {
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statusOptions: {
             /** 获取积分充值订单状态下拉选项与展示文案 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         verifyPayment: {
             /** 查询支付宝订单状态，如果已支付则完成充值 */
             post: (body: {
                 orderId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         notify: {
             alipay: {
                 /** 支付宝积分充值回调通知 */
-                post: (body: Record<string, unknown>, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
@@ -3196,7 +3785,7 @@ export interface ApiClient {
             /** 获取充值套餐列表（管理端） */
             post: (body: {
                 includeDisabled?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         create: {
             /** 创建新的充值套餐 */
@@ -3207,7 +3796,7 @@ export interface ApiClient {
                 bonus: number;
                 description?: string;
                 sort?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新充值套餐信息 */
@@ -3220,13 +3809,13 @@ export interface ApiClient {
                 description?: string;
                 sort?: number;
                 enabled?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除充值套餐 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         updateSort: {
             /** 批量更新套餐排序 */
@@ -3235,7 +3824,7 @@ export interface ApiClient {
                     id: string;
                     sort: number;
                 }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     refund: {
@@ -3245,7 +3834,7 @@ export interface ApiClient {
                 orderId: string;
                 reason?: string;
                 refundAmount?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         applySubscription: {
             /** 对已支付订阅账单申请退款 */
@@ -3254,7 +3843,7 @@ export interface ApiClient {
                 reason?: string;
                 refundAmount?: number;
                 subscriptionAction?: "cancel_immediate" | "none";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         approve: {
             /** 审批退款申请（通过或拒绝） */
@@ -3262,13 +3851,13 @@ export interface ApiClient {
                 refundNo: string;
                 action: "approve" | "reject";
                 remark?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         execute: {
             /** 执行已审批的退款（调用支付宝/微信退款接口） */
             post: (body: {
                 refundNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         manual: {
             /** 管理员手动标记退款完成（用于线上接口故障或特殊情况） */
@@ -3276,7 +3865,7 @@ export interface ApiClient {
                 refundNo: string;
                 manualRefundNo?: string;
                 remark: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         list: {
             /** 查询退款记录列表 */
@@ -3288,30 +3877,30 @@ export interface ApiClient {
                 userId?: string;
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         detail: {
             /** 查询单个退款单详情 */
             post: (body: {
                 refundNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         stats: {
             /** 获取退款统计数据 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         syncStatus: {
             /** 手动同步单个退款单的支付宝退款状态 */
             post: (body: {
                 refundNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statusOptions: {
             /** 获取退款单状态下拉选项与展示文案 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     serviceDefinition: {
@@ -3320,7 +3909,9 @@ export interface ApiClient {
             post: (body: {
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                keyword?: string;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         create: {
             /** 创建新的服务定义 */
@@ -3328,9 +3919,7 @@ export interface ApiClient {
                 serviceType: string;
                 name: string;
                 description?: string;
-                billingUnit: string;
-                billingMode?: "event" | "continuous";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新服务定义 */
@@ -3338,39 +3927,14 @@ export interface ApiClient {
                 id: string;
                 name?: string;
                 description?: string;
-                billingUnit?: string;
-                billingMode?: "event" | "continuous";
                 enabled?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除服务定义 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-    };
-    pricingRule: {
-        get: {
-            /** 获取服务的定价规则 */
-            post: (body: {
-                serviceType: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        save: {
-            /** 创建或更新定价规则 */
-            post: (body: {
-                serviceType: string;
-                tiers?: {
-                    minUsage: number;
-                    maxUsage: number | null;
-                    pricePerUnit: number;
-                }[];
-                flatPrice?: number | null;
-                freeQuota?: number;
-                profitMargin?: number;
-                enabled?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     usage: {
@@ -3378,17 +3942,20 @@ export interface ApiClient {
             /** 上报服务用量，自动计费扣费 */
             post: (body: {
                 serviceType: string;
+                chargeMethodKey?: string;
                 metadata: Record<string, unknown>;
-                requestId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                idempotencyKey?: string;
+                resourceId?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         preview: {
             /** 按当前定价规则预估本次用量费用，不写入记录、不扣积分 */
             post: (body: {
                 serviceType: string;
+                chargeMethodKey?: string;
                 metadata: Record<string, unknown>;
                 freeQuotaOverride?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         stats: {
             /** 获取用量统计数据 */
@@ -3396,18 +3963,257 @@ export interface ApiClient {
                 startDate?: string;
                 endDate?: string;
                 serviceType?: string;
+                userId?: string;
                 groupBy?: "day" | "service" | "user";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         records: {
             /** 获取用量记录列表 */
             post: (body: {
                 page?: number;
                 pageSize?: number;
-                serviceType?: string;
+                id?: string;
+                idempotencyKey?: string;
+                resourceId?: string;
+                serviceKey?: string;
+                chargeMethodKey?: string;
+                userId?: string;
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    servicePricing: {
+        overview: {
+            post: (config?: RequestConfig) => RequestBuilder<any>;
+        };
+        list: {
+            post: (body: {
+                serviceKey?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        get: {
+            post: (body: {
+                serviceKey: string;
+                chargeMethodKey: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        upsert: {
+            post: (body: {
+                serviceKey: string;
+                chargeMethodKey: string;
+                originalPrice: number;
+                sellPrice: number;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        importLegacy: {
+            /** 幂等：将旧 pricingRule 导入 billingServicePricing */
+            post: (config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    priceList: {
+        list: {
+            post: (body: {
+                serviceKey?: string;
+                chargeMethodKey?: string;
+                pricingType?: "flat" | "tiered" | "dimensions";
+                enabled?: boolean;
+                page?: number;
+                pageSize?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        get: {
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        create: {
+            post: (body: {
+                serviceKey: string;
+                chargeMethodKey: string;
+                name: string;
+                currency?: "CNY" | "USD";
+                enabled?: boolean;
+                pricing: {
+                    type: "flat";
+                    originalPrice: number;
+                    sellPrice: number;
+                } | {
+                    type: "tiered";
+                    priceStructure: "flat" | "segmented";
+                    tiers: {
+                        tierKey?: string;
+                        tierRangeMode?: "at_most" | "at_least" | "between";
+                        minTokens?: number;
+                        maxTokens?: number;
+                        minInclusive?: boolean;
+                        maxInclusive?: boolean;
+                        originalFenPerUnit: number;
+                        sellFenPerUnit: number;
+                        billingEnabled: boolean;
+                    }[];
+                } | {
+                    type: "dimensions";
+                    dimensions: {
+                        dimensionKey: string;
+                        unit: string;
+                        priceStructure?: "flat" | "segmented";
+                        tiers: {
+                            tierKey?: string;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                            minOutputTokens?: number;
+                            maxOutputTokens?: number;
+                            originalFenPerUnit: number;
+                            sellFenPerUnit: number;
+                            billingEnabled: boolean;
+                        }[];
+                    }[];
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        update: {
+            post: (body: {
+                id: string;
+                name?: string;
+                currency?: "CNY" | "USD";
+                enabled?: boolean;
+                pricing?: {
+                    type: "flat";
+                    originalPrice: number;
+                    sellPrice: number;
+                } | {
+                    type: "tiered";
+                    priceStructure: "flat" | "segmented";
+                    tiers: {
+                        tierKey?: string;
+                        tierRangeMode?: "at_most" | "at_least" | "between";
+                        minTokens?: number;
+                        maxTokens?: number;
+                        minInclusive?: boolean;
+                        maxInclusive?: boolean;
+                        originalFenPerUnit: number;
+                        sellFenPerUnit: number;
+                        billingEnabled: boolean;
+                    }[];
+                } | {
+                    type: "dimensions";
+                    dimensions: {
+                        dimensionKey: string;
+                        unit: string;
+                        priceStructure?: "flat" | "segmented";
+                        tiers: {
+                            tierKey?: string;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                            minOutputTokens?: number;
+                            maxOutputTokens?: number;
+                            originalFenPerUnit: number;
+                            sellFenPerUnit: number;
+                            billingEnabled: boolean;
+                        }[];
+                    }[];
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    priceBinding: {
+        list: {
+            post: (body: {
+                subjectType?: "model-profile";
+                subjectKey?: string;
+                serviceKey?: string;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        upsert: {
+            post: (body: {
+                subjectType: "model-profile";
+                subjectKey: string;
+                priceListId: string;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    billingMethodDefinition: {
+        list: {
+            post: (body: {
+                serviceKey?: string;
+                page?: number;
+                pageSize?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        get: {
+            post: (body: {
+                chargeMethodKey: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        create: {
+            post: (body: {
+                serviceKey: string;
+                chargeMethodKey: string;
+                label: string;
+                billingUnit: string;
+                chargeKind: "instant" | "settlement";
+                settlementPeriod?: "second" | "minute" | "hour" | "day" | "month";
+                priceStructure?: "flat" | "segmented";
+                tiers?: {
+                    tierKey?: string;
+                    tierRangeMode?: "at_most" | "at_least" | "between";
+                    minTokens?: number;
+                    maxTokens?: number;
+                    minInclusive?: boolean;
+                    maxInclusive?: boolean;
+                    originalFenPerUnit: number;
+                    sellFenPerUnit: number;
+                    billingEnabled: boolean;
+                }[];
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        update: {
+            post: (body: {
+                id: string;
+                label?: string;
+                billingUnit?: string;
+                chargeKind?: "instant" | "settlement";
+                settlementPeriod?: "second" | "minute" | "hour" | "day" | "month";
+                priceStructure?: "flat" | "segmented";
+                tiers?: {
+                    tierKey?: string;
+                    tierRangeMode?: "at_most" | "at_least" | "between";
+                    minTokens?: number;
+                    maxTokens?: number;
+                    minInclusive?: boolean;
+                    maxInclusive?: boolean;
+                    originalFenPerUnit: number;
+                    sellFenPerUnit: number;
+                    billingEnabled: boolean;
+                }[];
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     export: {
@@ -3417,7 +4223,7 @@ export interface ApiClient {
                 startDate?: string;
                 endDate?: string;
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         refund: {
             /** 导出退款记录为 CSV 格式 */
@@ -3425,7 +4231,7 @@ export interface ApiClient {
                 startDate?: string;
                 endDate?: string;
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         pointsHistory: {
             /** 导出积分变动记录为 CSV 格式 */
@@ -3434,7 +4240,7 @@ export interface ApiClient {
                 endDate?: string;
                 type?: string;
                 userId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     financeReport: {
@@ -3443,14 +4249,14 @@ export interface ApiClient {
             post: (body: {
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         trend: {
             /** 获取收入趋势数据（按日/周/月） */
             post: (body: {
                 period: "day" | "week" | "month";
                 days?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         packageRank: {
             /** 获取套餐销售排行数据 */
@@ -3458,7 +4264,7 @@ export interface ApiClient {
                 startDate?: string;
                 endDate?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         userRank: {
             /** 获取用户充值排行数据 */
@@ -3466,7 +4272,7 @@ export interface ApiClient {
                 startDate?: string;
                 endDate?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     reconciliation: {
@@ -3474,7 +4280,7 @@ export interface ApiClient {
             /** 生成指定日期的对账报告 */
             post: (body: {
                 date: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         list: {
             /** 查询对账报告列表 */
@@ -3484,13 +4290,13 @@ export interface ApiClient {
                 status?: string;
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         detail: {
             /** 查询对账报告详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         processAnomaly: {
             /** 处理对账异常订单 */
@@ -3499,14 +4305,14 @@ export interface ApiClient {
                 orderId: string;
                 action: "confirm_paid" | "mark_cancelled" | "ignore";
                 remark?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         batchGenerate: {
             /** 批量生成指定日期范围的对账报告 */
             post: (body: {
                 startDate: string;
                 endDate: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     invoice: {
@@ -3526,7 +4332,7 @@ export interface ApiClient {
                 receiverAddress?: string;
                 orderIds?: string[];
                 remark?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         list: {
             /** 查询发票申请列表 */
@@ -3537,13 +4343,13 @@ export interface ApiClient {
                 userId?: string;
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         detail: {
             /** 查询发票详情 */
             post: (body: {
                 invoiceNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         review: {
             /** 审核发票申请（通过/拒绝） */
@@ -3551,7 +4357,7 @@ export interface ApiClient {
                 invoiceNo: string;
                 action: "approve" | "reject";
                 remark?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         issue: {
             /** 标记发票已开具 */
@@ -3560,20 +4366,20 @@ export interface ApiClient {
                 invoiceCode?: string;
                 invoiceNumber?: string;
                 invoiceUrl?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         stats: {
             /** 获取发票统计数据 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         cancel: {
             /** 取消发票申请（仅待审核状态可取消） */
             post: (body: {
                 invoiceNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     agreement: {
@@ -3584,39 +4390,39 @@ export interface ApiClient {
                 period: number;
                 singleAmount: number;
                 totalAmount?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         query: {
             /** 查询签约状态 */
             post: (body: {
                 externalAgreementNo?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         my: {
             /** 获取当前用户的签约信息 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         unsign: {
             /** 解除签约授权 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         history: {
             /** 查询签约历史记录 */
             post: (body: {
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         deductLogs: {
             /** 查询代扣扣款记录 */
             post: (body: {
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         signNotify: {
             /** 支付宝签约异步通知回调 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     internal: {
@@ -3628,7 +4434,7 @@ export interface ApiClient {
                     userId: string;
                     event: string;
                     eventData?: Record<string, unknown>;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         usage: {
@@ -3637,10 +4443,11 @@ export interface ApiClient {
                 post: (body: {
                     appId: string;
                     userId: string;
-                    serviceType: string;
+                    serviceKey: string;
+                    chargeMethodKey: string;
                     amount: number;
                     freeQuotaOverride?: number;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             previewBatch: {
                 /** 供内部服务批量预估通用计费用量，不写入记录、不扣积分 */
@@ -3649,41 +4456,165 @@ export interface ApiClient {
                     items: {
                         key: string;
                         userId: string;
-                        serviceType: string;
+                        serviceKey: string;
+                        chargeMethodKey: string;
                         amount: number;
                         freeQuotaOverride?: number;
                     }[];
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             report: {
                 /** 供内部服务上报通用计费用量并扣积分 */
                 post: (body: {
                     appId: string;
                     userId: string;
-                    serviceType: string;
+                    serviceKey: string;
+                    chargeMethodKey: string;
                     amount: number;
                     metadata?: Record<string, unknown>;
-                    requestId?: string;
+                    idempotencyKey?: string;
+                    resourceId?: string;
                     usageKind?: "event" | "continuous_settlement";
                     periodStart?: string;
                     periodEnd?: string;
                     freeQuotaOverride?: number;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            reversal: {
+                /** 供内部服务冲正已上报的服务用量并退还积分 */
+                post: (body: {
+                    appId: string;
+                    userId: string;
+                    idempotencyKey: string;
+                    reason?: string;
+                    reversalIdempotencyKey?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'record-ai': {
+                /** 供 ai-server 计价后写入统一用量账本并扣积分 */
+                post: (body: {
+                    appId: string;
+                    userId: string;
+                    idempotencyKey: string;
+                    serviceKey: string;
+                    chargeMethodKey: string;
+                    resourceId?: string;
+                    subjectKey: string;
+                    labels?: Record<string, string>;
+                    pointsConsumed: number;
+                    quantity?: number;
+                    unit?: string;
+                    snapshot?: {
+                        priceListId?: string;
+                        usage?: Record<string, number>;
+                        cost?: Record<string, unknown>;
+                    };
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            list: {
+                /** 供 ai-server 等内部服务查询 billingUsageRecord */
+                post: (body: {
+                    appId: string;
+                    userId?: string;
+                    serviceGroup?: "ai" | "platform" | "storage";
+                    serviceGroups?: "ai" | "platform" | "storage"[];
+                    referenceId?: string;
+                    serviceKey?: string;
+                    chargeMethodKey?: string;
+                    model?: string;
+                    subjectKeys?: string[];
+                    id?: string;
+                    requestId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                    page?: number;
+                    pageSize?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'stats-ai': {
+                /** 供 ai-server 查询 AI 用量聚合统计 */
+                post: (body: {
+                    appId: string;
+                    userId?: string;
+                    subjectKeys?: string[];
+                    startTime?: string;
+                    endTime?: string;
+                    timezone?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'by-reference': {
+                /** 按 referenceId 联合查询用量与积分流水 */
+                post: (body: {
+                    appId: string;
+                    referenceId: string;
+                    serviceKey?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        pricing: {
+            'resolve-model': {
+                /** 供 ai-server 运行时读取模型定价 */
+                post: (body: {
+                    appId: string;
+                    supplierId: string;
+                    profileId: string;
+                    productLine?: string;
+                    billingPlan?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'sync-model': {
+                post: (body: {
+                    appId: string;
+                    operatorId: string;
+                    supplierId: string;
+                    profileId: string;
+                    productLine: string;
+                    currency: "CNY" | "USD";
+                    plans: unknown[];
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'delete-model': {
+                post: (body: {
+                    appId: string;
+                    supplierId: string;
+                    profileId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'load-model-plans': {
+                post: (body: {
+                    appId: string;
+                    supplierId: string;
+                    profileId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'list-model-pricing-map': {
+                post: (body: {
+                    appId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        points: {
+            'by-request-ids': {
+                /** 供 ai-server 溯源：通过 requestId 列表查询 pointsHistory */
+                post: (body: {
+                    appId: string;
+                    requestIds: string[];
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
     webhooks: {
         events: {
             /** 获取所有可用的 Webhook 事件类型 */
-            get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            get: (config?: RequestConfig) => RequestBuilder<any>;
             ':id': {
                 /** 获取指定分类的 Webhook 事件 */
-                get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                get: (config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         categories: {
             /** 获取所有 Webhook 事件分类 */
-            get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            get: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
 }