@huyooo/ui 0.13.4 → 0.13.8

package/dist/types/api/ai.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: {
@@ -12,38 +12,201 @@ export type Api = {
             return: any;
         };
     };
-    chat: {
+    agent: {
         models: {
-            /** 获取聊天可用的 AI 模型列表 */
+            /** 获取 Platform Agent 支持的模型列表（含定价信息） */
             get: {
                 return: any;
             };
         };
         stream: {
-            /** 发起流式 AI 对话请求 */
+            /** 发起流式 AI 对话请求（SSE），含计费 */
             post: {
                 body: {
-                    message: string;
+                    message?: string;
                     images?: string[];
+                    sessionId?: string;
+                    tools?: {
+                        name: string;
+                        description: string;
+                        parameters: {
+                            type: "object";
+                            properties: Record<string, {
+                                type?: string;
+                                description?: string;
+                                properties?: Record<string, unknown>;
+                                items?: unknown;
+                                required?: string[];
+                                enum?: unknown[];
+                                default?: unknown;
+                            }>;
+                            required?: string[];
+                            description?: string;
+                        };
+                    }[];
+                    skillContents?: string[];
                     options?: {
                         mode?: "agent" | "ask";
                         model?: string;
-                        provider?: "ark" | "deepseek" | "qwen" | "gemini" | "openai" | "anthropic";
                         enableWebSearch?: boolean;
                         thinkingMode?: "enabled" | "disabled";
                         enabledTools?: string[];
+                        autoRunConfig?: {
+                            mode?: "off" | "run-everything" | "approve-all";
+                        };
                         history?: {
                             role: "user" | "assistant" | "system" | "tool";
                             content: string;
+                            tool_call_id?: string;
+                            tool_calls?: {
+                                id: string;
+                                type: "function";
+                                function: {
+                                    name: string;
+                                    arguments: string;
+                                };
+                            }[];
                         }[];
+                        serviceTier?: string;
+                        billingPlan?: "online_standard" | "online_low_latency" | "batch";
                     };
                 };
                 return: any;
             };
         };
-        abort: {
-            /** 中止正在进行的对话请求 */
+        complete: {
+            /** 创建 Agent 非流式补全请求（含计费），使用 ai-chat-core 统一引擎 */
+            post: {
+                body: {
+                    model: string;
+                    max_tokens?: number;
+                    temperature?: number;
+                    messages: {
+                        role: "user" | "assistant" | "system";
+                        content: string | unknown[];
+                    }[];
+                    service_tier?: string;
+                    billing_plan?: "online_standard" | "online_low_latency" | "batch";
+                };
+                return: any;
+            };
+        };
+        cancel: {
+            /** 取消正在进行的对话请求 */
+            post: {
+                return: any;
+            };
+        };
+        sessions: {
+            /** 获取当前用户的所有会话 */
+            get: {
+                return: any;
+            };
+            /** 创建新的聊天会话 */
             post: {
+                body: {
+                    title?: string;
+                    model?: string;
+                    mode?: "agent" | "ask";
+                    webSearchEnabled?: boolean;
+                    thinkingEnabled?: boolean;
+                };
+                return: any;
+            };
+            ':id': {
+                /** 更新会话信息 */
+                put: {
+                    body: {
+                        title?: string;
+                        model?: string;
+                        mode?: "agent" | "ask";
+                        webSearchEnabled?: boolean;
+                        thinkingEnabled?: boolean;
+                        hidden?: boolean;
+                    };
+                    params: {
+                        sessionId: string;
+                    };
+                    return: any;
+                };
+                /** 删除会话及其所有消息 */
+                delete: {
+                    params: {
+                        sessionId: string;
+                    };
+                    return: any;
+                };
+                messages: {
+                    /** 获取会话的所有消息 */
+                    get: {
+                        params: {
+                            sessionId: string;
+                        };
+                        return: any;
+                    };
+                    /** 保存聊天消息 */
+                    post: {
+                        body: {
+                            id?: string;
+                            role: "user" | "assistant";
+                            content: string;
+                            images?: string[];
+                            model?: string;
+                            mode?: string;
+                            webSearchEnabled?: boolean;
+                            thinkingEnabled?: boolean;
+                            steps?: string;
+                            operationIds?: string;
+                        };
+                        params: {
+                            sessionId: string;
+                        };
+                        return: any;
+                    };
+                    after: {
+                        ':id': {
+                            /** 用于分叉：删除指定消息之后的所有消息 */
+                            delete: {
+                                params: {
+                                    sessionId: string;
+                                    messageId: string;
+                                };
+                                return: any;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        messages: {
+            ':id': {
+                /** 更新消息内容（支持 usage、duration、operationIds），含归属验证 */
+                put: {
+                    body: {
+                        content?: string;
+                        steps?: string;
+                        operationIds?: string;
+                        usage?: string;
+                        duration?: number;
+                    };
+                    params: {
+                        id: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        settings: {
+            /** 获取用户的 Platform Agent 设置 */
+            get: {
+                return: any;
+            };
+            /** 更新用户的 Platform Agent 设置 */
+            put: {
+                body: {
+                    key: string;
+                    value: string;
+                };
                 return: any;
             };
         };
@@ -195,7 +358,7 @@ export type Api = {
                     modelIds: string[];
                     promptTestDataIds: string[];
                     status: "enabled" | "disabled";
-                    providers: "ark" | "deepseek" | "qwen" | "gemini" | "openai" | "anthropic" | "openrouter"[];
+                    providers: string[];
                     description: string;
                 };
                 return: any;
@@ -220,7 +383,7 @@ export type Api = {
                     modelIds: string[];
                     promptTestDataIds: string[];
                     status: "enabled" | "disabled";
-                    providers: "ark" | "deepseek" | "qwen" | "gemini" | "openai" | "anthropic" | "openrouter"[];
+                    providers: string[];
                     description: string;
                 };
                 return: any;
@@ -259,26 +422,8 @@ export type Api = {
                 return: any;
             };
         };
-    };
-    completions: {
-        create: {
-            /** 创建 AI 补全请求 */
-            post: {
-                body: {
-                    model: string;
-                    max_tokens?: number;
-                    stream?: boolean;
-                    temperature?: number;
-                    messages: {
-                        role: "user" | "assistant" | "system";
-                        content: string | unknown[];
-                    }[];
-                };
-                return: any;
-            };
-        };
-        prompt: {
-            /** 基于提示词模板进行 AI 补全 */
+        run: {
+            /** 基于提示词模板进行 AI 补全（含计费） */
             post: {
                 body: {
                     promptId: string;
@@ -288,8 +433,9 @@ export type Api = {
                     }[];
                     model: string;
                     max_tokens?: number;
-                    stream?: boolean;
                     temperature?: number;
+                    service_tier?: string;
+                    billing_plan?: "online_standard" | "online_low_latency" | "batch";
                 };
                 return: any;
             };
@@ -304,7 +450,290 @@ export type Api = {
             };
         };
     };
-    promptsHistroy: {
+    dashscope: {
+        'compatible-mode': {
+            v1: {
+                chat: {
+                    completions: {
+                        /** 原样代理 DashScope compatible-mode /chat/completions，并统一加登录态、额度和计费 */
+                        post: {
+                            body: Record<string, unknown>;
+                            return: any;
+                        };
+                    };
+                };
+            };
+        };
+        api: {
+            v1: {
+                services: {
+                    aigc: {
+                        'text-generation': {
+                            generation: {
+                                /** 原样代理 DashScope 原生 text-generation，并统一加登录态、额度和计费 */
+                                post: {
+                                    body: Record<string, unknown>;
+                                    return: any;
+                                };
+                            };
+                        };
+                        'multimodal-generation': {
+                            generation: {
+                                /** 原样代理 DashScope 原生 multimodal-generation，并统一加登录态、额度和计费 */
+                                post: {
+                                    body: Record<string, unknown>;
+                                    return: any;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+    deepseek: {
+        v1: {
+            chat: {
+                completions: {
+                    /** 原样代理 DeepSeek /chat/completions，并统一加登录态、额度和计费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+            };
+        };
+    };
+    openrouter: {
+        v1: {
+            chat: {
+                completions: {
+                    /** 原样代理 OpenRouter /chat/completions，并统一加登录态、额度和计费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+            };
+        };
+    };
+    openai: {
+        v1: {
+            responses: {
+                /** 原样代理 OpenAI /responses，并统一加登录态、额度和计费 */
+                post: {
+                    body: Record<string, unknown>;
+                    return: any;
+                };
+            };
+            chat: {
+                completions: {
+                    /** 原样代理 OpenAI /chat/completions，并统一加登录态、额度和计费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+            };
+            images: {
+                generations: {
+                    /** 原样代理 OpenAI /images/generations（DALL·E 按张 · GPT Image 按 token） */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+                edits: {
+                    /** 原样代理 OpenAI /images/edits（GPT Image 按 token · multipart） */
+                    post: {
+                        return: any;
+                    };
+                };
+            };
+        };
+    };
+    anthropic: {
+        v1: {
+            messages: {
+                /** 原样代理 Anthropic /messages，并统一加登录态、额度和计费 */
+                post: {
+                    body: Record<string, unknown>;
+                    return: any;
+                };
+            };
+        };
+    };
+    gemini: {
+        v1beta: {
+            models: {
+                ':id': {
+                    /** 原样代理 Gemini /models/{model}:generateContent 等接口，并统一加登录态、额度和计费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        params: {
+                            modelAction: string;
+                        };
+                        return: any;
+                    };
+                };
+            };
+        };
+    };
+    glm: {
+        v1: {
+            chat: {
+                completions: {
+                    /** 原样代理 GLM /chat/completions，并统一加登录态、额度和计费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+            };
+        };
+    };
+    grok: {
+        v1: {
+            responses: {
+                /** 通过 LLM Proxy 原样代理 Grok /responses，并统一加登录态、额度和计费 */
+                post: {
+                    body: Record<string, unknown>;
+                    return: any;
+                };
+            };
+            chat: {
+                completions: {
+                    /** 通过 LLM Proxy 原样代理 Grok /chat/completions，并统一加登录态、额度和计费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+            };
+            images: {
+                generations: {
+                    /** 通过 LLM Proxy 原样代理 Grok /images/generations，并按张计费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+            };
+            videos: {
+                generations: {
+                    /** 通过 LLM Proxy 代理 Grok /videos/generations，提交任务不扣费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+                ':id': {
+                    /** 通过 LLM Proxy 转发 Grok /videos/{request_id}，视频生成成功后按秒扣费 */
+                    get: {
+                        params: {
+                            requestId: string;
+                        };
+                        return: any;
+                    };
+                };
+            };
+        };
+    };
+    moonshot: {
+        v1: {
+            chat: {
+                completions: {
+                    /** 原样代理 Moonshot /chat/completions，并统一加登录态、额度和计费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+            };
+        };
+    };
+    minimax: {
+        anthropic: {
+            v1: {
+                messages: {
+                    /** 原样代理 MiniMax Anthropic /messages，并统一加登录态、额度和计费 */
+                    post: {
+                        body: Record<string, unknown>;
+                        return: any;
+                    };
+                };
+            };
+        };
+    };
+    volcengine: {
+        ark: {
+            api: {
+                v3: {
+                    responses: {
+                        /** 原样代理火山方舟原厂 /api/v3/responses，并统一加登录态、额度和计费 */
+                        post: {
+                            body: Record<string, unknown>;
+                            return: any;
+                        };
+                    };
+                    chat: {
+                        completions: {
+                            /** 原样代理火山方舟原厂 /api/v3/chat/completions，并统一加登录态、额度和计费 */
+                            post: {
+                                body: Record<string, unknown>;
+                                return: any;
+                            };
+                        };
+                    };
+                };
+                plan: {
+                    v3: {
+                        chat: {
+                            completions: {
+                                /** 平台暂未开放 Agent Plan 官方线路 */
+                                post: {
+                                    body: Record<string, unknown>;
+                                    return: any;
+                                };
+                            };
+                        };
+                    };
+                    v1: {
+                        messages: {
+                            /** 平台暂未开放 Agent Plan 官方线路 */
+                            post: {
+                                body: Record<string, unknown>;
+                                return: any;
+                            };
+                        };
+                    };
+                };
+                coding: {
+                    v3: {
+                        chat: {
+                            completions: {
+                                /** 平台暂未开放 Coding Plan 官方线路 */
+                                post: {
+                                    body: Record<string, unknown>;
+                                    return: any;
+                                };
+                            };
+                        };
+                    };
+                    v1: {
+                        messages: {
+                            /** 平台暂未开放 Coding Plan 官方线路 */
+                            post: {
+                                body: Record<string, unknown>;
+                                return: any;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+    promptsHistory: {
         find: {
             /** 分页查询提示词历史记录 */
             post: {
@@ -433,7 +862,7 @@ export type Api = {
                         enableChannelSplit?: boolean;
                         showUtterances?: boolean;
                         vadSegment?: boolean;
-                        context: unknown;
+                        context?: unknown;
                     };
                 };
                 return: any;
@@ -462,6 +891,15 @@ export type Api = {
                 return: any;
             };
         };
+        findOne: {
+            /** 根据 ID 查询单条 ASR 任务详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
         status: {
             /** 查询 ASR 任务处理状态 */
             post: {
@@ -482,13 +920,23 @@ export type Api = {
     };
     tts: {
         create: {
-            /** 创建新的 TTS 任务 */
+            /** 创建新的 TTS 任务；默认 V3 单向流式，长文本需显式传 synthesisMode=longText */
             post: {
                 body: {
-                    sceneKey: string;
+                    voiceKind: "official" | "clone" | "design";
                     voiceType: string;
                     text: string;
-                    encoding?: "wav";
+                    encoding?: "wav" | "pcm";
+                    synthesisMode?: "unidirectional" | "longText";
+                };
+                return: any;
+            };
+        };
+        status: {
+            /** 查询长文本 TTS 任务处理状态（仅 synthesisMode=longText） */
+            post: {
+                body: {
+                    id: string;
                 };
                 return: any;
             };
@@ -509,7 +957,7 @@ export type Api = {
                     current: number;
                     pageSize: number;
                     where: {
-                        sceneKey?: string;
+                        voiceKind?: "official" | "clone" | "design";
                         voiceType?: string;
                         text?: string;
                     };
@@ -529,7 +977,7 @@ export type Api = {
     };
     si: {
         create: {
-            /** 创建新的同声传译任务 */
+            /** 创建新的同声传译任务（ASR → 翻译 → TTS） */
             post: {
                 body: {
                     audios: {
@@ -543,6 +991,15 @@ export type Api = {
                 return: any;
             };
         };
+        status: {
+            /** 查询同声传译任务当前状态与结果 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
         delete: {
             /** 删除同声传译任务 */
             post: {
@@ -559,11 +1016,8 @@ export type Api = {
                     current: number;
                     pageSize: number;
                     where: {
-                        name?: string;
-                        value?: string;
-                        version?: number;
-                        modelId?: string;
-                        providerId?: string;
+                        speakerID?: string;
+                        language?: string;
                         status?: string;
                     };
                 };
@@ -580,9 +1034,61 @@ export type Api = {
             };
         };
     };
+    realtimeSpeech: {
+        session: {
+            create: {
+                /** 创建实时语音交互会话（complete 时扣费） */
+                post: {
+                    body: {
+                        language?: string;
+                        modelType?: 0 | 1;
+                    };
+                    return: any;
+                };
+            };
+            complete: {
+                /** 提交上游 usage 并完成实时语音扣费 */
+                post: {
+                    body: {
+                        id: string;
+                        usage: {
+                            inputAudioTokens: number;
+                            outputTextTokens: number;
+                            outputAudioTokens: number;
+                            inputAudioCachedTokens?: number;
+                        };
+                    };
+                    return: any;
+                };
+            };
+        };
+        find: {
+            /** 分页查询实时语音会话 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        sessionId?: string;
+                        status?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询实时语音会话详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+    };
     copyVoice: {
         create: {
-            /** 创建新的声音复刻任务 */
+            /** 创建新的声音复刻任务（调用火山引擎下单） */
             post: {
                 body: {
                     name: string;
@@ -592,6 +1098,20 @@ export type Api = {
                 };
                 return: any;
             };
+            speakerID: {
+                /** 通过已有的 speakerID 创建声音复刻记录 */
+                post: {
+                    body: {
+                        name: string;
+                        tags: string[];
+                        times: number;
+                        description?: string;
+                        speakerID: string;
+                        orderID: string;
+                    };
+                    return: any;
+                };
+            };
         };
         update: {
             /** 更新声音复刻信息 */
@@ -641,22 +1161,133 @@ export type Api = {
                 };
             };
         };
-    };
-    voiceTypes: {
-        create: {
-            /** 创建新音色类型 */
+        trains: {
+            /** 上传音频文件进行声音复刻训练 */
             post: {
                 body: {
-                    name: string;
-                    value: string;
-                    modelIds: string[];
-                    promptTestDataIds: string[];
-                    status: "enabled" | "disabled";
-                    providers: string[];
-                    description: string;
-                };
-                return: any;
-            };
+                    id: string;
+                    audios: {
+                        audioFormat: "wav" | "mp3" | "ogg" | "m4a" | "aac" | "pcm";
+                        audioBytes: string;
+                        text?: string;
+                    }[];
+                    language: number;
+                };
+                return: any;
+            };
+        };
+        status: {
+            /** 查询声音复刻的训练状态 */
+            post: {
+                body: {
+                    speakerID: string;
+                };
+                return: any;
+            };
+        };
+    };
+    voiceDesign: {
+        create: {
+            /** 下单购买音色槽位，用于后续音色设计 */
+            post: {
+                body: {
+                    name: string;
+                    tags: string[];
+                    times: number;
+                    description?: string;
+                };
+                return: any;
+            };
+        };
+        design: {
+            /** 基于文本/图片提示词设计音色并生成试听 */
+            post: {
+                body: {
+                    id: string;
+                    previewText: string;
+                    textPrompt?: string;
+                    language?: 0 | 1;
+                    imagePrompt?: {
+                        imageUrl?: string;
+                        imageBytes?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新音色设计名称、标签与描述 */
+            post: {
+                body: {
+                    id: string;
+                    name: string;
+                    tags: string[];
+                    description?: string;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询音色设计任务 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        name?: string;
+                        speakerID?: string;
+                        status?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询音色设计详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        status: {
+            /** 从上游刷新 SpeakerID 状态 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        options: {
+            /** 获取音色设计下拉选项 */
+            post: {
+                return: any;
+            };
+            status: {
+                /** 获取音色设计状态下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+        };
+    };
+    voiceTypes: {
+        create: {
+            /** 创建新音色类型 */
+            post: {
+                body: {
+                    name: string;
+                    value: string;
+                    modelIds: string[];
+                    promptTestDataIds: string[];
+                    status: "enabled" | "disabled";
+                    providers: string[];
+                    description: string;
+                };
+                return: any;
+            };
         };
         delete: {
             /** 删除音色类型 */
@@ -714,12 +1345,14 @@ export type Api = {
             /** 获取音色下拉选项 */
             post: {
                 body: {
-                    sceneKey?: string;
+                    voiceKind?: "official" | "clone" | "design";
+                    category?: string;
+                    resourceId?: string;
                 };
                 return: any;
             };
-            voiceScene: {
-                /** 获取音色场景下拉选项 */
+            categories: {
+                /** 聚合 ListSpeakers 返回的分类列表 */
                 post: {
                     return: any;
                 };
@@ -783,7 +1416,7 @@ export type Api = {
     };
     copyVoiceRenew: {
         create: {
-            /** 创建声音复刻续期申请 */
+            /** 创建声音复刻续期申请（调用火山引擎续费 API） */
             post: {
                 body: {
                     copyVoiceId: string;
@@ -817,20 +1450,58 @@ export type Api = {
             };
         };
     };
+    voiceDesignRenew: {
+        create: {
+            /** 创建音色设计续期申请（调用火山引擎续费 API） */
+            post: {
+                body: {
+                    voiceDesignId: string;
+                    times: number;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询音色设计续期列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        speakerID?: string;
+                        voiceDesignId?: string;
+                        status?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询音色设计续期详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+    };
     imageGeneration: {
         create: {
-            /** 创建新的图片生成任务 */
+            /** 创建新的图片生成任务（火山方舟，后台异步处理） */
             post: {
                 body: {
                     model: string;
                     prompt: string;
                     sizeType?: "resolution" | "pixel";
-                    size?: "1K" | "2K" | "4K";
+                    size?: "1K" | "2K" | "3K" | "4K";
                     width?: number;
                     height?: number;
                     watermark?: boolean;
-                    guidanceScale?: number;
-                    seed?: number;
+                    outputFormat?: "png" | "jpeg";
+                    referenceImageUrls?: string[];
+                    sequentialImageGeneration?: "disabled" | "auto";
+                    maxImages?: number;
                 };
                 return: any;
             };
@@ -866,10 +1537,24 @@ export type Api = {
                 return: any;
             };
         };
+        options: {
+            status: {
+                /** 获取图片生成任务状态下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+            model: {
+                /** 获取豆包 Seedream 图片模型下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+        };
     };
     videoGeneration: {
         create: {
-            /** 创建新的视频生成任务 */
+            /** 创建新的视频生成任务（提交不扣费，请轮询 /status） */
             post: {
                 body: {
                     model?: string;
@@ -885,6 +1570,15 @@ export type Api = {
                 return: any;
             };
         };
+        status: {
+            /** 查询 Veo 任务状态 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
         delete: {
             /** 删除视频生成任务 */
             post: {
@@ -918,7 +1612,7 @@ export type Api = {
             };
         };
         refresh: {
-            /** 刷新视频生成任务状态 */
+            /** 刷新视频生成任务状态（不扣费） */
             post: {
                 body: {
                     id: string;
@@ -933,24 +1627,63 @@ export type Api = {
                     return: any;
                 };
             };
+            model: {
+                /** 获取 Google Veo 视频模型下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+        };
+        progress: {
+            ':id': {
+                /** 通过 SSE 实时获取视频生成任务进度（需登录，仅任务创建者可访问） */
+                get: {
+                    params: {
+                        id: string;
+                    };
+                    return: any;
+                };
+            };
         };
     };
-    geminiImage: {
+    seedanceVideoGeneration: {
         create: {
-            /** 创建 Gemini 图片生成任务 */
+            /** 提交火山方舟 Seedance 异步视频任务 */
             post: {
                 body: {
-                    model?: string;
-                    prompt: string;
-                    negativePrompt?: string;
-                    aspectRatio?: string;
-                    numberOfImages?: number;
+                    model: string;
+                    content: unknown[];
+                    ratio?: string;
+                    duration?: number;
+                    resolution?: string;
+                    watermark?: boolean;
+                    generate_audio?: boolean;
+                    seed?: number;
+                    service_tier?: string;
+                };
+                return: any;
+            };
+        };
+        status: {
+            /** 轮询火山方舟任务状态 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        refresh: {
+            /** 轮询上游任务状态 */
+            post: {
+                body: {
+                    id: string;
                 };
                 return: any;
             };
         };
         delete: {
-            /** 删除 Gemini 图片生成任务 */
+            /** 删除 Seedance 视频任务记录 */
             post: {
                 body: {
                     id: string;
@@ -959,12 +1692,12 @@ export type Api = {
             };
         };
         find: {
-            /** 分页查询 Gemini 图片列表 */
+            /** 分页查询 Seedance 视频任务 */
             post: {
                 body: {
-                    pageSize: number;
                     current: number;
-                    where?: {
+                    pageSize: number;
+                    where: {
                         prompt?: string;
                         status?: string;
                     };
@@ -973,7 +1706,7 @@ export type Api = {
             };
         };
         findOne: {
-            /** 根据 ID 查询 Gemini 图片详情 */
+            /** 查询单条 Seedance 视频任务 */
             post: {
                 body: {
                     id: string;
@@ -983,91 +1716,1056 @@ export type Api = {
         };
         options: {
             status: {
-                /** 获取 Gemini 图片状态下拉选项 */
-                post: {
-                    return: any;
-                };
-            };
-            model: {
-                /** 获取 Gemini 图片模型下拉选项 */
-                post: {
-                    return: any;
-                };
-            };
-            aspectRatio: {
-                /** 获取 Gemini 图片宽高比下拉选项 */
-                post: {
-                    return: any;
-                };
-            };
-            resolution: {
-                /** 获取 Gemini 图片分辨率下拉选项 */
+                /** 获取 Seedance 视频任务状态下拉选项 */
                 post: {
                     return: any;
                 };
             };
         };
     };
-    webhooks: {
-        events: {
-            /** 获取所有可用的 Webhook 事件类型 */
-            get: {
+    mesh3dGeneration: {
+        create: {
+            /** 提交火山方舟 3D 异步生成任务 */
+            post: {
+                body: {
+                    model: string;
+                    content: unknown[];
+                    subdivision_level?: string;
+                    file_format?: string;
+                    seed?: number;
+                };
                 return: any;
             };
-            ':id': {
-                /** 获取指定分类的 Webhook 事件 */
-                get: {
-                    params: {
-                        category: string;
-                    };
-                    return: any;
+        };
+        status: {
+            /** 轮询火山方舟 3D 任务状态 */
+            post: {
+                body: {
+                    id: string;
                 };
+                return: any;
             };
         };
-        categories: {
-            /** 获取所有 Webhook 事件分类 */
-            get: {
+        refresh: {
+            /** 轮询上游 3D 任务状态 */
+            post: {
+                body: {
+                    id: string;
+                };
                 return: any;
             };
         };
-    };
-};
-/** API 客户端类型（提供完整的 IDE 智能提示） */
-export interface ApiClient {
-    health: {
-        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        delete: {
+            /** 删除 3D 生成任务记录 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询 3D 生成任务 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        prompt?: string;
+                        status?: string;
+                        supplierId?: string;
+                        model?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 查询单条 3D 生成任务 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        options: {
+            status: {
+                /** 获取 3D 生成任务状态下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+        };
+    };
+    geminiImage: {
+        create: {
+            /** 经 LLM Proxy 异步生成 Gemini 图片（提交不扣费，请轮询 /status） */
+            post: {
+                body: {
+                    model?: string;
+                    prompt: string;
+                    negativePrompt?: string;
+                    aspectRatio?: string;
+                    numberOfImages?: number;
+                    personGeneration?: string;
+                    resolution?: string;
+                    referenceImageBase64?: string;
+                    referenceImageMimeType?: string;
+                };
+                return: any;
+            };
+        };
+        status: {
+            /** 查询 Gemini 生图任务状态 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除 Gemini 图片生成任务 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询 Gemini 图片列表 */
+            post: {
+                body: {
+                    pageSize: number;
+                    current: number;
+                    where?: {
+                        prompt?: string;
+                        status?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询 Gemini 图片详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        options: {
+            status: {
+                /** 获取 Gemini 图片状态下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+            model: {
+                /** 获取 Gemini 图片模型下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+            aspectRatio: {
+                /** 获取 Gemini 图片宽高比下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+            resolution: {
+                /** 获取 Gemini 图片分辨率下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+        };
+    };
+    billing: {
+        balance: {
+            /** 查询用户积分余额 */
+            post: {
+                body: Record<string, unknown>;
+                return: any;
+            };
+        };
+        estimate: {
+            /** 根据 token 数量预估费用 */
+            post: {
+                body: {
+                    model: string;
+                    promptTokens: number;
+                    completionTokens: number;
+                };
+                return: any;
+            };
+        };
+        usage: {
+            stats: {
+                /** 统计用户的 AI 使用情况 */
+                post: {
+                    body: {
+                        userId?: string;
+                        model?: string;
+                        supplierId?: string;
+                        profileId?: string;
+                        protocolId?: string;
+                        startTime?: string;
+                        endTime?: string;
+                    };
+                    return: any;
+                };
+            };
+            list: {
+                /** 查询用户的 AI 使用记录 */
+                post: {
+                    body: {
+                        userId?: string;
+                        model?: string;
+                        supplierId?: string;
+                        profileId?: string;
+                        protocolId?: string;
+                        productLine?: "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                        id?: string;
+                        requestId?: string;
+                        referenceId?: string;
+                        startTime?: string;
+                        endTime?: string;
+                        page?: number;
+                        pageSize?: number;
+                    };
+                    return: any;
+                };
+            };
+        };
+        trace: {
+            reference: {
+                /** 按 referenceId 查询用量与积分流水 */
+                post: {
+                    body: {
+                        referenceId: string;
+                        serviceKey?: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+    };
+    modelCatalog: {
+        suppliers: {
+            list: {
+                post: {
+                    body: {
+                        enabledOnly?: boolean;
+                        supplierKind?: "agent_vendor" | "agent_proxy";
+                        agentVendorOnly?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            upsert: {
+                post: {
+                    body: {
+                        supplierId: string;
+                        name: string;
+                        supplierKind: "agent_vendor" | "agent_proxy";
+                        enabled?: boolean;
+                        description?: string;
+                        platformUpstream: "direct" | "proxy_railway";
+                        downstreamAccessModes: "official" | "self_key"[];
+                    };
+                    return: any;
+                };
+            };
+            delete: {
+                post: {
+                    body: {
+                        supplierId: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        protocols: {
+            find: {
+                post: {
+                    body: {
+                        page?: number;
+                        pageSize?: number;
+                        supplierId?: string;
+                        keyword?: string;
+                        enabled?: boolean;
+                        chatRuntimeEnabled?: boolean;
+                        method?: "POST" | "GET";
+                    };
+                    return: any;
+                };
+            };
+            listBySupplier: {
+                post: {
+                    body: {
+                        supplierId: string;
+                        enabledOnly?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            create: {
+                post: {
+                    body: {
+                        protocolId: string;
+                        supplierId: string;
+                        name: string;
+                        baseUrl: string;
+                        path: string;
+                        chatRuntimeProtocol?: string;
+                        method?: "POST" | "GET";
+                        docUrl?: string;
+                        description?: string;
+                        enabled?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            update: {
+                post: {
+                    body: {
+                        protocolId: string;
+                        supplierId?: string;
+                        name?: string;
+                        baseUrl?: string;
+                        path?: string;
+                        chatRuntimeProtocol?: string;
+                        method?: "POST" | "GET";
+                        docUrl?: string;
+                        description?: string;
+                        enabled?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            delete: {
+                post: {
+                    body: {
+                        protocolId: string;
+                    };
+                    return: any;
+                };
+            };
+            supplierOptions: {
+                /** 协议管理筛选用供应商全量（key/label） */
+                post: {
+                    return: any;
+                };
+            };
+            protocolOptions: {
+                /** 按供应商加载接入协议选项（key/label） */
+                post: {
+                    body: {
+                        supplierId: string;
+                        enabledOnly?: boolean;
+                    };
+                    return: any;
+                };
+            };
+        };
+        profiles: {
+            find: {
+                post: {
+                    body: {
+                        page?: number;
+                        pageSize?: number;
+                        referenceVendor?: string;
+                        family?: string;
+                        tag?: string;
+                        keyword?: string;
+                        status?: "active" | "deprecated";
+                        inputType?: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d";
+                        outputType?: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d";
+                    };
+                    return: any;
+                };
+            };
+            listBrief: {
+                post: {
+                    body: {
+                        enabledOnly?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            referenceVendorOptions: {
+                /** 模型信息筛选用原厂供应商全量（key/label） */
+                post: {
+                    body: {
+                        enabledOnly?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            create: {
+                post: {
+                    body: {
+                        profileId: string;
+                        referenceVendor: string;
+                        name: string;
+                        family?: string;
+                        tags?: string[];
+                        description?: string;
+                        capabilities: {
+                            productLine?: "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                            inputTypes: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d"[];
+                            outputType: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d";
+                            rateLimits?: {
+                                tpmPerMinute?: number;
+                                rpmPerMinute?: number;
+                                qpmPerMinute?: number;
+                                ipmPerMinute?: number;
+                                maxConcurrency?: number;
+                            };
+                            text?: {
+                                contextWindow?: number;
+                                maxInputTokens?: number;
+                                maxOutputTokens?: number;
+                                maxThinkingTokens?: number;
+                            };
+                            image?: {
+                                minWidth?: number;
+                                minHeight?: number;
+                                maxWidth?: number;
+                                maxHeight?: number;
+                                maxImagesPerRequest?: number;
+                                supportedAspectRatios?: string[];
+                                supportsInpainting?: boolean;
+                            };
+                            video?: {
+                                supportedResolutions?: string[];
+                                maxFps?: number;
+                                maxDurationSeconds?: number;
+                                minDurationSeconds?: number;
+                                supportedAspectRatios?: string[];
+                                supportsImageToVideo?: boolean;
+                                supportsVideoExtend?: boolean;
+                            };
+                            mesh3d?: {
+                                supportsImageTo3d?: boolean;
+                                outputFormats?: string[];
+                                maxPolygons?: number;
+                            };
+                            speech?: {
+                                mode: "tts" | "asr";
+                                billingMode?: "token_io" | "inference_chars" | "inference_hour" | "realtime_duplex";
+                            };
+                            embedding?: {
+                                contextWindow?: number;
+                                dimensions?: number;
+                                maxInputTokens?: number;
+                                maxBatchSize?: number;
+                                normalization?: "l2" | "none";
+                            };
+                            webSearchDetail?: {
+                                maxResults?: number;
+                            };
+                            thinking?: boolean;
+                            structuredOutput?: boolean;
+                            contextCache?: boolean;
+                            onlineInference?: boolean;
+                            lowLatencyInference?: boolean;
+                            batchInference?: boolean;
+                            fineTuning?: boolean;
+                            toolUse?: boolean;
+                            webSearch?: boolean;
+                            knowledgeBase?: boolean;
+                            mcp?: boolean;
+                        };
+                        status?: "active" | "deprecated";
+                    };
+                    return: any;
+                };
+            };
+            update: {
+                post: {
+                    body: {
+                        profileId: string;
+                        referenceVendor?: string;
+                        name?: string;
+                        family?: string;
+                        tags?: string[];
+                        description?: string;
+                        capabilities?: {
+                            productLine?: "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                            inputTypes: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d"[];
+                            outputType: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d";
+                            rateLimits?: {
+                                tpmPerMinute?: number;
+                                rpmPerMinute?: number;
+                                qpmPerMinute?: number;
+                                ipmPerMinute?: number;
+                                maxConcurrency?: number;
+                            };
+                            text?: {
+                                contextWindow?: number;
+                                maxInputTokens?: number;
+                                maxOutputTokens?: number;
+                                maxThinkingTokens?: number;
+                            };
+                            image?: {
+                                minWidth?: number;
+                                minHeight?: number;
+                                maxWidth?: number;
+                                maxHeight?: number;
+                                maxImagesPerRequest?: number;
+                                supportedAspectRatios?: string[];
+                                supportsInpainting?: boolean;
+                            };
+                            video?: {
+                                supportedResolutions?: string[];
+                                maxFps?: number;
+                                maxDurationSeconds?: number;
+                                minDurationSeconds?: number;
+                                supportedAspectRatios?: string[];
+                                supportsImageToVideo?: boolean;
+                                supportsVideoExtend?: boolean;
+                            };
+                            mesh3d?: {
+                                supportsImageTo3d?: boolean;
+                                outputFormats?: string[];
+                                maxPolygons?: number;
+                            };
+                            speech?: {
+                                mode: "tts" | "asr";
+                                billingMode?: "token_io" | "inference_chars" | "inference_hour" | "realtime_duplex";
+                            };
+                            embedding?: {
+                                contextWindow?: number;
+                                dimensions?: number;
+                                maxInputTokens?: number;
+                                maxBatchSize?: number;
+                                normalization?: "l2" | "none";
+                            };
+                            webSearchDetail?: {
+                                maxResults?: number;
+                            };
+                            thinking?: boolean;
+                            structuredOutput?: boolean;
+                            contextCache?: boolean;
+                            onlineInference?: boolean;
+                            lowLatencyInference?: boolean;
+                            batchInference?: boolean;
+                            fineTuning?: boolean;
+                            toolUse?: boolean;
+                            webSearch?: boolean;
+                            knowledgeBase?: boolean;
+                            mcp?: boolean;
+                        };
+                        status?: "active" | "deprecated";
+                    };
+                    return: any;
+                };
+            };
+            delete: {
+                post: {
+                    body: {
+                        profileId: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        offerings: {
+            supplierOptions: {
+                /** 管理后台筛选用供应商全量（key/label） */
+                post: {
+                    return: any;
+                };
+            };
+            profileOptions: {
+                /** 管理后台筛选用模型信息全量（key/label） */
+                post: {
+                    return: any;
+                };
+            };
+            modelOptions: {
+                /** 管理后台筛选用计费标识全量（key/label/value，支持联动筛选） */
+                post: {
+                    body: {
+                        supplierId?: string;
+                        profileId?: string;
+                        protocolId?: string;
+                        tag?: string;
+                        enabled?: boolean;
+                    };
+                    return: any;
+                };
+            };
+        };
+        models: {
+            find: {
+                post: {
+                    body: {
+                        page?: number;
+                        pageSize?: number;
+                        profileId?: string;
+                        referenceVendor?: string;
+                        supplierId?: string;
+                        supplierKind?: "agent_vendor" | "agent_proxy";
+                        protocolId?: string;
+                        tag?: string;
+                        productLine?: "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                        keyword?: string;
+                        enabled?: boolean;
+                        platformAvailable?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            unconfigured: {
+                post: {
+                    body: {
+                        supplierId?: string;
+                        supplierKind?: "agent_vendor" | "agent_proxy";
+                    };
+                    return: any;
+                };
+            };
+            create: {
+                post: {
+                    body: {
+                        profileId: string;
+                        supplierId: string;
+                        protocolId: string;
+                        providerModelId: string;
+                        name?: string;
+                        version?: string;
+                        status?: "active" | "deprecated";
+                        enabled?: boolean;
+                        description?: string;
+                    };
+                    return: any;
+                };
+            };
+            update: {
+                post: {
+                    body: {
+                        modelId: string;
+                        supplierId?: string;
+                        profileId?: string;
+                        protocolId?: string;
+                        providerModelId?: string;
+                        name?: string;
+                        version?: string;
+                        status?: "active" | "deprecated";
+                        enabled?: boolean;
+                        description?: string;
+                    };
+                    return: any;
+                };
+            };
+            delete: {
+                post: {
+                    body: {
+                        modelId: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        chat: {
+            supplierOptions: {
+                /** 获取下游应用对话模型设置可用的供应商（与 Ones 已启用 aiSupplier 列表一致） */
+                post: {
+                    return: any;
+                };
+            };
+            modelOptions: {
+                /** 获取下游应用可用的对话模型目录项（已启用 text_generation） */
+                post: {
+                    body: {
+                        supplierIds?: string[];
+                    };
+                    return: any;
+                };
+            };
+            integrationExport: {
+                /** 按 offeringModelId 生成 LLMConfig 片段与下游 API 说明，供 Ones 复制或调试 */
+                post: {
+                    body: {
+                        offeringModelId: string;
+                    };
+                    return: any;
+                };
+            };
+            reloadRuntime: {
+                /** 目录或 Key 变更后，从 Mongo 重新编译 /agent/* 可用模型（无需重启进程） */
+                post: {
+                    return: any;
+                };
+            };
+        };
+        prompt: {
+            supplierOptions: {
+                /** Prompt 模块：筛选平台 Runtime 已就绪的文本模型供应商 */
+                post: {
+                    return: any;
+                };
+            };
+            modelOptions: {
+                /** Prompt 模块：从平台 Runtime 目录筛选文本模型（offering modelId + providerModelId） */
+                post: {
+                    body: {
+                        supplierIds?: string[];
+                    };
+                    return: any;
+                };
+            };
+        };
+    };
+    billingCatalog: {
+        suppliers: {
+            list: {
+                /** 获取 AI 模型供应商列表 */
+                post: {
+                    body: {
+                        enabledOnly?: boolean;
+                        supplierKind?: "agent_vendor" | "agent_proxy";
+                        agentVendorOnly?: boolean;
+                    };
+                    return: any;
+                };
+            };
+        };
+        models: {
+            find: {
+                post: {
+                    body: {
+                        page?: number;
+                        pageSize?: number;
+                        supplierId?: string;
+                        profileId?: string;
+                        protocolId?: string;
+                        tag?: string;
+                        keyword?: string;
+                        enabled?: boolean;
+                    };
+                    return: any;
+                };
+            };
+        };
+        billingEntries: {
+            list: {
+                /** 按 supplier+profile 聚合的价表列表 */
+                post: {
+                    body: {
+                        page?: number;
+                        pageSize?: number;
+                        supplierId?: string;
+                        profileId?: string;
+                        productLine?: "" | "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                        keyword?: string;
+                        pricingConfigured?: boolean;
+                        billable?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            unconfigured: {
+                post: {
+                    body: {
+                        supplierId?: string;
+                        productLine?: "" | "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                        keyword?: string;
+                    };
+                    return: any;
+                };
+            };
+            get: {
+                post: {
+                    body: {
+                        supplierId: string;
+                        profileId: string;
+                    };
+                    return: any;
+                };
+            };
+            statuses: {
+                post: {
+                    return: any;
+                };
+            };
+        };
+        modelPricing: {
+            delete: {
+                post: {
+                    body: {
+                        supplierId: string;
+                        profileId: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        builtinServices: {
+            list: {
+                /** 只读内置 serviceKey 与 chargeMethodKey catalog */
+                post: {
+                    body: {
+                        group?: "ai" | "storage" | "platform";
+                    };
+                    return: any;
+                };
+            };
+        };
+        exchangeRate: {
+            get: {
+                post: {
+                    return: any;
+                };
+            };
+            update: {
+                post: {
+                    body: {
+                        usdToCny: number;
+                    };
+                    return: any;
+                };
+            };
+        };
+    };
+    embeddings: {
+        create: {
+            /** 将文本转换为向量（豆包 doubao-embedding-vision-250615），含计费 */
+            post: {
+                body: {
+                    model?: string;
+                    input: string;
+                    dimensions?: number;
+                    instructions?: string;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除向量生成任务记录 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询向量生成任务 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        input?: string;
+                        supplierId?: string;
+                        model?: string;
+                        status?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 查询单条向量生成任务 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        options: {
+            status: {
+                /** 获取向量任务状态下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+        };
+    };
+    webhooks: {
+        events: {
+            /** 获取所有可用的 Webhook 事件类型 */
+            get: {
+                return: any;
+            };
+            ':id': {
+                /** 获取指定分类的 Webhook 事件 */
+                get: {
+                    params: {
+                        category: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        categories: {
+            /** 获取所有 Webhook 事件分类 */
+            get: {
+                return: any;
+            };
+        };
+    };
+};
+/** API 客户端类型（提供完整的 IDE 智能提示） */
+export interface ApiClient {
+    health: {
+        get: (config?: RequestConfig) => RequestBuilder<any>;
     };
     'api-spec': {
         /** 获取 API 规范，用于类型同步 */
-        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        get: (config?: RequestConfig) => RequestBuilder<any>;
     };
-    chat: {
+    agent: {
         models: {
-            /** 获取聊天可用的 AI 模型列表 */
-            get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            /** 获取 Platform Agent 支持的模型列表（含定价信息） */
+            get: (config?: RequestConfig) => RequestBuilder<any>;
         };
         stream: {
-            /** 发起流式 AI 对话请求 */
+            /** 发起流式 AI 对话请求（SSE），含计费 */
             post: (body: {
-                message: string;
+                message?: string;
                 images?: string[];
+                sessionId?: string;
+                tools?: {
+                    name: string;
+                    description: string;
+                    parameters: {
+                        type: "object";
+                        properties: Record<string, {
+                            type?: string;
+                            description?: string;
+                            properties?: Record<string, unknown>;
+                            items?: unknown;
+                            required?: string[];
+                            enum?: unknown[];
+                            default?: unknown;
+                        }>;
+                        required?: string[];
+                        description?: string;
+                    };
+                }[];
+                skillContents?: string[];
                 options?: {
                     mode?: "agent" | "ask";
                     model?: string;
-                    provider?: "ark" | "deepseek" | "qwen" | "gemini" | "openai" | "anthropic";
                     enableWebSearch?: boolean;
                     thinkingMode?: "enabled" | "disabled";
                     enabledTools?: string[];
+                    autoRunConfig?: {
+                        mode?: "off" | "run-everything" | "approve-all";
+                    };
                     history?: {
                         role: "user" | "assistant" | "system" | "tool";
                         content: string;
+                        tool_call_id?: string;
+                        tool_calls?: {
+                            id: string;
+                            type: "function";
+                            function: {
+                                name: string;
+                                arguments: string;
+                            };
+                        }[];
                     }[];
+                    serviceTier?: string;
+                    billingPlan?: "online_standard" | "online_low_latency" | "batch";
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        complete: {
+            /** 创建 Agent 非流式补全请求（含计费），使用 ai-chat-core 统一引擎 */
+            post: (body: {
+                model: string;
+                max_tokens?: number;
+                temperature?: number;
+                messages: {
+                    role: "user" | "assistant" | "system";
+                    content: string | unknown[];
+                }[];
+                service_tier?: string;
+                billing_plan?: "online_standard" | "online_low_latency" | "batch";
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        cancel: {
+            /** 取消正在进行的对话请求 */
+            post: (config?: RequestConfig) => RequestBuilder<any>;
+        };
+        sessions: {
+            /** 获取当前用户的所有会话 */
+            get: (config?: RequestConfig) => RequestBuilder<any>;
+            /** 创建新的聊天会话 */
+            post: (body: {
+                title?: string;
+                model?: string;
+                mode?: "agent" | "ask";
+                webSearchEnabled?: boolean;
+                thinkingEnabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+            ':id': {
+                /** 更新会话信息 */
+                put: (body: {
+                    title?: string;
+                    model?: string;
+                    mode?: "agent" | "ask";
+                    webSearchEnabled?: boolean;
+                    thinkingEnabled?: boolean;
+                    hidden?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+                /** 删除会话及其所有消息 */
+                delete: (config?: RequestConfig) => RequestBuilder<any>;
+                messages: {
+                    /** 获取会话的所有消息 */
+                    get: (config?: RequestConfig) => RequestBuilder<any>;
+                    /** 保存聊天消息 */
+                    post: (body: {
+                        id?: string;
+                        role: "user" | "assistant";
+                        content: string;
+                        images?: string[];
+                        model?: string;
+                        mode?: string;
+                        webSearchEnabled?: boolean;
+                        thinkingEnabled?: boolean;
+                        steps?: string;
+                        operationIds?: string;
+                    }, config?: RequestConfig) => RequestBuilder<any>;
+                    after: {
+                        ':id': {
+                            /** 用于分叉：删除指定消息之后的所有消息 */
+                            delete: (config?: RequestConfig) => RequestBuilder<any>;
+                        };
+                    };
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        messages: {
+            ':id': {
+                /** 更新消息内容（支持 usage、duration、operationIds），含归属验证 */
+                put: (body: {
+                    content?: string;
+                    steps?: string;
+                    operationIds?: string;
+                    usage?: string;
+                    duration?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
         };
-        abort: {
-            /** 中止正在进行的对话请求 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        settings: {
+            /** 获取用户的 Platform Agent 设置 */
+            get: (config?: RequestConfig) => RequestBuilder<any>;
+            /** 更新用户的 Platform Agent 设置 */
+            put: (body: {
+                key: string;
+                value: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     models: {
@@ -1104,13 +2802,13 @@ export interface ApiClient {
                     baseURL: string;
                     mappingModel: string;
                 }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除模型配置 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新模型配置 */
@@ -1145,7 +2843,7 @@ export interface ApiClient {
                     baseURL: string;
                     mappingModel: string;
                 }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询模型配置列表 */
@@ -1156,31 +2854,31 @@ export interface ApiClient {
                     name?: string;
                     provider?: 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>;
         };
         options: {
             /** 获取模型下拉选项 */
             post: (body: {
                 providers?: string[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         typesOptions: {
             /** 获取模型类型下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         modelProviderOptions: {
             /** 获取模型供应商下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         tagsOptions: {
             /** 获取模型标签下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     prompts: {
@@ -1192,15 +2890,15 @@ export interface ApiClient {
                 modelIds: string[];
                 promptTestDataIds: string[];
                 status: "enabled" | "disabled";
-                providers: "ark" | "deepseek" | "qwen" | "gemini" | "openai" | "anthropic" | "openrouter"[];
+                providers: string[];
                 description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除提示词 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新提示词内容 */
@@ -1211,9 +2909,9 @@ export interface ApiClient {
                 modelIds: string[];
                 promptTestDataIds: string[];
                 status: "enabled" | "disabled";
-                providers: "ark" | "deepseek" | "qwen" | "gemini" | "openai" | "anthropic" | "openrouter"[];
+                providers: string[];
                 description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询提示词列表 */
@@ -1228,35 +2926,20 @@ export interface ApiClient {
                     providerId?: string;
                     status?: 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>;
         };
         options: {
             /** 获取提示词下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
-    };
-    completions: {
-        create: {
-            /** 创建 AI 补全请求 */
-            post: (body: {
-                model: string;
-                max_tokens?: number;
-                stream?: boolean;
-                temperature?: number;
-                messages: {
-                    role: "user" | "assistant" | "system";
-                    content: string | unknown[];
-                }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        prompt: {
-            /** 基于提示词模板进行 AI 补全 */
+        run: {
+            /** 基于提示词模板进行 AI 补全（含计费） */
             post: (body: {
                 promptId: string;
                 promptVars: {
@@ -1265,18 +2948,223 @@ export interface ApiClient {
                 }[];
                 model: string;
                 max_tokens?: number;
-                stream?: boolean;
                 temperature?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                service_tier?: string;
+                billing_plan?: "online_standard" | "online_low_latency" | "batch";
+            }, config?: RequestConfig) => RequestBuilder<any>;
             models: {
                 /** 获取指定提示词可用的模型列表 */
                 post: (body: {
                     promptId: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    dashscope: {
+        'compatible-mode': {
+            v1: {
+                chat: {
+                    completions: {
+                        /** 原样代理 DashScope compatible-mode /chat/completions，并统一加登录态、额度和计费 */
+                        post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                    };
+                };
+            };
+        };
+        api: {
+            v1: {
+                services: {
+                    aigc: {
+                        'text-generation': {
+                            generation: {
+                                /** 原样代理 DashScope 原生 text-generation，并统一加登录态、额度和计费 */
+                                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                            };
+                        };
+                        'multimodal-generation': {
+                            generation: {
+                                /** 原样代理 DashScope 原生 multimodal-generation，并统一加登录态、额度和计费 */
+                                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+    deepseek: {
+        v1: {
+            chat: {
+                completions: {
+                    /** 原样代理 DeepSeek /chat/completions，并统一加登录态、额度和计费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+        };
+    };
+    openrouter: {
+        v1: {
+            chat: {
+                completions: {
+                    /** 原样代理 OpenRouter /chat/completions，并统一加登录态、额度和计费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+        };
+    };
+    openai: {
+        v1: {
+            responses: {
+                /** 原样代理 OpenAI /responses，并统一加登录态、额度和计费 */
+                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            chat: {
+                completions: {
+                    /** 原样代理 OpenAI /chat/completions，并统一加登录态、额度和计费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+            images: {
+                generations: {
+                    /** 原样代理 OpenAI /images/generations（DALL·E 按张 · GPT Image 按 token） */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+                edits: {
+                    /** 原样代理 OpenAI /images/edits（GPT Image 按 token · multipart） */
+                    post: (config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+        };
+    };
+    anthropic: {
+        v1: {
+            messages: {
+                /** 原样代理 Anthropic /messages，并统一加登录态、额度和计费 */
+                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    gemini: {
+        v1beta: {
+            models: {
+                ':id': {
+                    /** 原样代理 Gemini /models/{model}:generateContent 等接口，并统一加登录态、额度和计费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+        };
+    };
+    glm: {
+        v1: {
+            chat: {
+                completions: {
+                    /** 原样代理 GLM /chat/completions，并统一加登录态、额度和计费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+        };
+    };
+    grok: {
+        v1: {
+            responses: {
+                /** 通过 LLM Proxy 原样代理 Grok /responses，并统一加登录态、额度和计费 */
+                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            chat: {
+                completions: {
+                    /** 通过 LLM Proxy 原样代理 Grok /chat/completions，并统一加登录态、额度和计费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+            images: {
+                generations: {
+                    /** 通过 LLM Proxy 原样代理 Grok /images/generations，并按张计费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+            videos: {
+                generations: {
+                    /** 通过 LLM Proxy 代理 Grok /videos/generations，提交任务不扣费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+                ':id': {
+                    /** 通过 LLM Proxy 转发 Grok /videos/{request_id}，视频生成成功后按秒扣费 */
+                    get: (config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+        };
+    };
+    moonshot: {
+        v1: {
+            chat: {
+                completions: {
+                    /** 原样代理 Moonshot /chat/completions，并统一加登录态、额度和计费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+        };
+    };
+    minimax: {
+        anthropic: {
+            v1: {
+                messages: {
+                    /** 原样代理 MiniMax Anthropic /messages，并统一加登录态、额度和计费 */
+                    post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+        };
+    };
+    volcengine: {
+        ark: {
+            api: {
+                v3: {
+                    responses: {
+                        /** 原样代理火山方舟原厂 /api/v3/responses，并统一加登录态、额度和计费 */
+                        post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                    };
+                    chat: {
+                        completions: {
+                            /** 原样代理火山方舟原厂 /api/v3/chat/completions，并统一加登录态、额度和计费 */
+                            post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                        };
+                    };
+                };
+                plan: {
+                    v3: {
+                        chat: {
+                            completions: {
+                                /** 平台暂未开放 Agent Plan 官方线路 */
+                                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                            };
+                        };
+                    };
+                    v1: {
+                        messages: {
+                            /** 平台暂未开放 Agent Plan 官方线路 */
+                            post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                        };
+                    };
+                };
+                coding: {
+                    v3: {
+                        chat: {
+                            completions: {
+                                /** 平台暂未开放 Coding Plan 官方线路 */
+                                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                            };
+                        };
+                    };
+                    v1: {
+                        messages: {
+                            /** 平台暂未开放 Coding Plan 官方线路 */
+                            post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+                        };
+                    };
+                };
             };
         };
     };
-    promptsHistroy: {
+    promptsHistory: {
         find: {
             /** 分页查询提示词历史记录 */
             post: (body: {
@@ -1287,25 +3175,25 @@ export interface ApiClient {
                     value?: string;
                     version?: number;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询提示词历史详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         options: {
             /** 获取提示词历史版本下拉选项 */
             post: (body: {
                 promptId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         rollback: {
             /** 将提示词回滚到指定历史版本 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     promptTestData: {
@@ -1315,13 +3203,13 @@ export interface ApiClient {
                 name: string;
                 value: string;
                 description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除提示词测试数据 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新提示词测试数据 */
@@ -1330,7 +3218,7 @@ export interface ApiClient {
                 name: string;
                 value: string;
                 description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询提示词测试数据列表 */
@@ -1342,17 +3230,17 @@ export interface ApiClient {
                     value?: string;
                     modelId?: 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>;
         };
         options: {
             /** 获取提示词测试数据下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     asr: {
@@ -1375,15 +3263,15 @@ export interface ApiClient {
                     enableChannelSplit?: boolean;
                     showUtterances?: boolean;
                     vadSegment?: boolean;
-                    context: unknown;
+                    context?: unknown;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除 ASR 任务 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询 ASR 任务列表 */
@@ -1394,36 +3282,49 @@ export interface ApiClient {
                     id?: string;
                     status?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            /** 根据 ID 查询单条 ASR 任务详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         status: {
             /** 查询 ASR 任务处理状态 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         options: {
             status: {
                 /** 获取 ASR 任务状态下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
     tts: {
         create: {
-            /** 创建新的 TTS 任务 */
+            /** 创建新的 TTS 任务；默认 V3 单向流式，长文本需显式传 synthesisMode=longText */
             post: (body: {
-                sceneKey: string;
+                voiceKind: "official" | "clone" | "design";
                 voiceType: string;
                 text: string;
-                encoding?: "wav";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                encoding?: "wav" | "pcm";
+                synthesisMode?: "unidirectional" | "longText";
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        status: {
+            /** 查询长文本 TTS 任务处理状态（仅 synthesisMode=longText） */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除 TTS 任务 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询 TTS 任务列表 */
@@ -1431,22 +3332,22 @@ export interface ApiClient {
                 current: number;
                 pageSize: number;
                 where: {
-                    sceneKey?: string;
+                    voiceKind?: "official" | "clone" | "design";
                     voiceType?: string;
                     text?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询 TTS 任务详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     si: {
         create: {
-            /** 创建新的同声传译任务 */
+            /** 创建新的同声传译任务（ASR → 翻译 → TTS） */
             post: (body: {
                 audios: {
                     audioFormat: "wav" | "mp3" | "ogg" | "m4a" | "aac" | "pcm";
@@ -1455,13 +3356,19 @@ export interface ApiClient {
                 }[];
                 language: string;
                 modelType: 0 | 1;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        status: {
+            /** 查询同声传译任务当前状态与结果 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除同声传译任务 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询同声传译任务列表 */
@@ -1469,31 +3376,79 @@ export interface ApiClient {
                 current: number;
                 pageSize: number;
                 where: {
-                    name?: string;
-                    value?: string;
-                    version?: number;
-                    modelId?: string;
-                    providerId?: string;
+                    speakerID?: string;
+                    language?: string;
                     status?: 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>;
+        };
+    };
+    realtimeSpeech: {
+        session: {
+            create: {
+                /** 创建实时语音交互会话（complete 时扣费） */
+                post: (body: {
+                    language?: string;
+                    modelType?: 0 | 1;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            complete: {
+                /** 提交上游 usage 并完成实时语音扣费 */
+                post: (body: {
+                    id: string;
+                    usage: {
+                        inputAudioTokens: number;
+                        outputTextTokens: number;
+                        outputAudioTokens: number;
+                        inputAudioCachedTokens?: number;
+                    };
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        find: {
+            /** 分页查询实时语音会话 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    sessionId?: string;
+                    status?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            /** 根据 ID 查询实时语音会话详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     copyVoice: {
         create: {
-            /** 创建新的声音复刻任务 */
+            /** 创建新的声音复刻任务（调用火山引擎下单） */
             post: (body: {
                 name: string;
                 tags: string[];
                 times: number;
                 description?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+            speakerID: {
+                /** 通过已有的 speakerID 创建声音复刻记录 */
+                post: (body: {
+                    name: string;
+                    tags: string[];
+                    times: number;
+                    description?: string;
+                    speakerID: string;
+                    orderID: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
         };
         update: {
             /** 更新声音复刻信息 */
@@ -1502,7 +3457,7 @@ export interface ApiClient {
                 name: string;
                 tags: string[];
                 description?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询声音复刻任务列表 */
@@ -1514,20 +3469,103 @@ export interface ApiClient {
                     speakerID?: string;
                     status?: 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>;
         };
         options: {
             /** 获取声音复刻下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
             status: {
                 /** 获取声音复刻状态下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        trains: {
+            /** 上传音频文件进行声音复刻训练 */
+            post: (body: {
+                id: string;
+                audios: {
+                    audioFormat: "wav" | "mp3" | "ogg" | "m4a" | "aac" | "pcm";
+                    audioBytes: string;
+                    text?: string;
+                }[];
+                language: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        status: {
+            /** 查询声音复刻的训练状态 */
+            post: (body: {
+                speakerID: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    voiceDesign: {
+        create: {
+            /** 下单购买音色槽位，用于后续音色设计 */
+            post: (body: {
+                name: string;
+                tags: string[];
+                times: number;
+                description?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        design: {
+            /** 基于文本/图片提示词设计音色并生成试听 */
+            post: (body: {
+                id: string;
+                previewText: string;
+                textPrompt?: string;
+                language?: 0 | 1;
+                imagePrompt?: {
+                    imageUrl?: string;
+                    imageBytes?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        update: {
+            /** 更新音色设计名称、标签与描述 */
+            post: (body: {
+                id: string;
+                name: string;
+                tags: string[];
+                description?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        find: {
+            /** 分页查询音色设计任务 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    name?: string;
+                    speakerID?: string;
+                    status?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            /** 根据 ID 查询音色设计详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        status: {
+            /** 从上游刷新 SpeakerID 状态 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        options: {
+            /** 获取音色设计下拉选项 */
+            post: (config?: RequestConfig) => RequestBuilder<any>;
+            status: {
+                /** 获取音色设计状态下拉选项 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
@@ -1542,13 +3580,13 @@ export interface ApiClient {
                 status: "enabled" | "disabled";
                 providers: string[];
                 description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除音色类型 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新音色信息 */
@@ -1561,7 +3599,7 @@ export interface ApiClient {
                 status: "enabled" | "disabled";
                 providers: string[];
                 description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询音色类型列表 */
@@ -1576,22 +3614,24 @@ export interface ApiClient {
                     providerId?: string;
                     status?: 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>;
         };
         options: {
             /** 获取音色下拉选项 */
             post: (body: {
-                sceneKey?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-            voiceScene: {
-                /** 获取音色场景下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                voiceKind?: "official" | "clone" | "design";
+                category?: string;
+                resourceId?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+            categories: {
+                /** 聚合 ListSpeakers 返回的分类列表 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
@@ -1606,7 +3646,7 @@ export interface ApiClient {
                     text?: string;
                 }[];
                 language: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询声音训练任务列表 */
@@ -1618,72 +3658,101 @@ export interface ApiClient {
                     language?: number;
                     status?: number;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询声音训练任务详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        options: {
-            status: {
-                /** 获取声音训练状态下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
-            };
-            language: {
-                /** 获取声音训练语言下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
-            };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        options: {
+            status: {
+                /** 获取声音训练状态下拉选项 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+            language: {
+                /** 获取声音训练语言下拉选项 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    copyVoiceRenew: {
+        create: {
+            /** 创建声音复刻续期申请（调用火山引擎续费 API） */
+            post: (body: {
+                copyVoiceId: string;
+                times: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        find: {
+            /** 分页查询声音复刻续期列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    speakerID?: string;
+                    copyVoiceId?: string;
+                    status?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            /** 根据 ID 查询声音复刻续期详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
-    copyVoiceRenew: {
+    voiceDesignRenew: {
         create: {
-            /** 创建声音复刻续期申请 */
+            /** 创建音色设计续期申请（调用火山引擎续费 API） */
             post: (body: {
-                copyVoiceId: string;
+                voiceDesignId: string;
                 times: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
-            /** 分页查询声音复刻续期列表 */
+            /** 分页查询音色设计续期列表 */
             post: (body: {
                 current: number;
                 pageSize: number;
                 where: {
                     speakerID?: string;
-                    copyVoiceId?: string;
+                    voiceDesignId?: string;
                     status?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
-            /** 根据 ID 查询声音复刻续期详情 */
+            /** 根据 ID 查询音色设计续期详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     imageGeneration: {
         create: {
-            /** 创建新的图片生成任务 */
+            /** 创建新的图片生成任务（火山方舟，后台异步处理） */
             post: (body: {
                 model: string;
                 prompt: string;
                 sizeType?: "resolution" | "pixel";
-                size?: "1K" | "2K" | "4K";
+                size?: "1K" | "2K" | "3K" | "4K";
                 width?: number;
                 height?: number;
                 watermark?: boolean;
-                guidanceScale?: number;
-                seed?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                outputFormat?: "png" | "jpeg";
+                referenceImageUrls?: string[];
+                sequentialImageGeneration?: "disabled" | "auto";
+                maxImages?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除图片生成任务 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询图片生成任务列表 */
@@ -1693,18 +3762,28 @@ export interface ApiClient {
                 where: {
                     prompt?: 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>;
+        };
+        options: {
+            status: {
+                /** 获取图片生成任务状态下拉选项 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+            model: {
+                /** 获取豆包 Seedream 图片模型下拉选项 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
         };
     };
     videoGeneration: {
         create: {
-            /** 创建新的视频生成任务 */
+            /** 创建新的视频生成任务（提交不扣费，请轮询 /status） */
             post: (body: {
                 model?: string;
                 prompt: string;
@@ -1715,13 +3794,19 @@ export interface ApiClient {
                 personGeneration?: string;
                 numberOfVideos?: number;
                 seed?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        status: {
+            /** 查询 Veo 任务状态 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除视频生成任务 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询视频生成任务列表 */
@@ -1732,43 +3817,175 @@ export interface ApiClient {
                     prompt?: string;
                     status?: 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>;
         };
         refresh: {
-            /** 刷新视频生成任务状态 */
+            /** 刷新视频生成任务状态（不扣费） */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         options: {
             status: {
                 /** 获取视频生成任务状态下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+            model: {
+                /** 获取 Google Veo 视频模型下拉选项 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        progress: {
+            ':id': {
+                /** 通过 SSE 实时获取视频生成任务进度（需登录，仅任务创建者可访问） */
+                get: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    seedanceVideoGeneration: {
+        create: {
+            /** 提交火山方舟 Seedance 异步视频任务 */
+            post: (body: {
+                model: string;
+                content: unknown[];
+                ratio?: string;
+                duration?: number;
+                resolution?: string;
+                watermark?: boolean;
+                generate_audio?: boolean;
+                seed?: number;
+                service_tier?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        status: {
+            /** 轮询火山方舟任务状态 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        refresh: {
+            /** 轮询上游任务状态 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            /** 删除 Seedance 视频任务记录 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        find: {
+            /** 分页查询 Seedance 视频任务 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    prompt?: string;
+                    status?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            /** 查询单条 Seedance 视频任务 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        options: {
+            status: {
+                /** 获取 Seedance 视频任务状态下拉选项 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    mesh3dGeneration: {
+        create: {
+            /** 提交火山方舟 3D 异步生成任务 */
+            post: (body: {
+                model: string;
+                content: unknown[];
+                subdivision_level?: string;
+                file_format?: string;
+                seed?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        status: {
+            /** 轮询火山方舟 3D 任务状态 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        refresh: {
+            /** 轮询上游 3D 任务状态 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            /** 删除 3D 生成任务记录 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        find: {
+            /** 分页查询 3D 生成任务 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    prompt?: string;
+                    status?: string;
+                    supplierId?: string;
+                    model?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            /** 查询单条 3D 生成任务 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        options: {
+            status: {
+                /** 获取 3D 生成任务状态下拉选项 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
     geminiImage: {
         create: {
-            /** 创建 Gemini 图片生成任务 */
+            /** 经 LLM Proxy 异步生成 Gemini 图片（提交不扣费，请轮询 /status） */
             post: (body: {
                 model?: string;
                 prompt: string;
                 negativePrompt?: string;
                 aspectRatio?: string;
                 numberOfImages?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                personGeneration?: string;
+                resolution?: string;
+                referenceImageBase64?: string;
+                referenceImageMimeType?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        status: {
+            /** 查询 Gemini 生图任务状态 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除 Gemini 图片生成任务 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询 Gemini 图片列表 */
@@ -1779,45 +3996,610 @@ export interface ApiClient {
                     prompt?: string;
                     status?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询 Gemini 图片详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         options: {
             status: {
                 /** 获取 Gemini 图片状态下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
             model: {
                 /** 获取 Gemini 图片模型下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
             aspectRatio: {
                 /** 获取 Gemini 图片宽高比下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
             resolution: {
                 /** 获取 Gemini 图片分辨率下拉选项 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    billing: {
+        balance: {
+            /** 查询用户积分余额 */
+            post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        estimate: {
+            /** 根据 token 数量预估费用 */
+            post: (body: {
+                model: string;
+                promptTokens: number;
+                completionTokens: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        usage: {
+            stats: {
+                /** 统计用户的 AI 使用情况 */
+                post: (body: {
+                    userId?: string;
+                    model?: string;
+                    supplierId?: string;
+                    profileId?: string;
+                    protocolId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            list: {
+                /** 查询用户的 AI 使用记录 */
+                post: (body: {
+                    userId?: string;
+                    model?: string;
+                    supplierId?: string;
+                    profileId?: string;
+                    protocolId?: string;
+                    productLine?: "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                    id?: string;
+                    requestId?: string;
+                    referenceId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                    page?: number;
+                    pageSize?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        trace: {
+            reference: {
+                /** 按 referenceId 查询用量与积分流水 */
+                post: (body: {
+                    referenceId: string;
+                    serviceKey?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    modelCatalog: {
+        suppliers: {
+            list: {
+                post: (body: {
+                    enabledOnly?: boolean;
+                    supplierKind?: "agent_vendor" | "agent_proxy";
+                    agentVendorOnly?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            upsert: {
+                post: (body: {
+                    supplierId: string;
+                    name: string;
+                    supplierKind: "agent_vendor" | "agent_proxy";
+                    enabled?: boolean;
+                    description?: string;
+                    platformUpstream: "direct" | "proxy_railway";
+                    downstreamAccessModes: "official" | "self_key"[];
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            delete: {
+                post: (body: {
+                    supplierId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        protocols: {
+            find: {
+                post: (body: {
+                    page?: number;
+                    pageSize?: number;
+                    supplierId?: string;
+                    keyword?: string;
+                    enabled?: boolean;
+                    chatRuntimeEnabled?: boolean;
+                    method?: "POST" | "GET";
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            listBySupplier: {
+                post: (body: {
+                    supplierId: string;
+                    enabledOnly?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            create: {
+                post: (body: {
+                    protocolId: string;
+                    supplierId: string;
+                    name: string;
+                    baseUrl: string;
+                    path: string;
+                    chatRuntimeProtocol?: string;
+                    method?: "POST" | "GET";
+                    docUrl?: string;
+                    description?: string;
+                    enabled?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            update: {
+                post: (body: {
+                    protocolId: string;
+                    supplierId?: string;
+                    name?: string;
+                    baseUrl?: string;
+                    path?: string;
+                    chatRuntimeProtocol?: string;
+                    method?: "POST" | "GET";
+                    docUrl?: string;
+                    description?: string;
+                    enabled?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            delete: {
+                post: (body: {
+                    protocolId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            supplierOptions: {
+                /** 协议管理筛选用供应商全量（key/label） */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+            protocolOptions: {
+                /** 按供应商加载接入协议选项（key/label） */
+                post: (body: {
+                    supplierId: string;
+                    enabledOnly?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        profiles: {
+            find: {
+                post: (body: {
+                    page?: number;
+                    pageSize?: number;
+                    referenceVendor?: string;
+                    family?: string;
+                    tag?: string;
+                    keyword?: string;
+                    status?: "active" | "deprecated";
+                    inputType?: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d";
+                    outputType?: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d";
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            listBrief: {
+                post: (body: {
+                    enabledOnly?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            referenceVendorOptions: {
+                /** 模型信息筛选用原厂供应商全量（key/label） */
+                post: (body: {
+                    enabledOnly?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            create: {
+                post: (body: {
+                    profileId: string;
+                    referenceVendor: string;
+                    name: string;
+                    family?: string;
+                    tags?: string[];
+                    description?: string;
+                    capabilities: {
+                        productLine?: "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                        inputTypes: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d"[];
+                        outputType: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d";
+                        rateLimits?: {
+                            tpmPerMinute?: number;
+                            rpmPerMinute?: number;
+                            qpmPerMinute?: number;
+                            ipmPerMinute?: number;
+                            maxConcurrency?: number;
+                        };
+                        text?: {
+                            contextWindow?: number;
+                            maxInputTokens?: number;
+                            maxOutputTokens?: number;
+                            maxThinkingTokens?: number;
+                        };
+                        image?: {
+                            minWidth?: number;
+                            minHeight?: number;
+                            maxWidth?: number;
+                            maxHeight?: number;
+                            maxImagesPerRequest?: number;
+                            supportedAspectRatios?: string[];
+                            supportsInpainting?: boolean;
+                        };
+                        video?: {
+                            supportedResolutions?: string[];
+                            maxFps?: number;
+                            maxDurationSeconds?: number;
+                            minDurationSeconds?: number;
+                            supportedAspectRatios?: string[];
+                            supportsImageToVideo?: boolean;
+                            supportsVideoExtend?: boolean;
+                        };
+                        mesh3d?: {
+                            supportsImageTo3d?: boolean;
+                            outputFormats?: string[];
+                            maxPolygons?: number;
+                        };
+                        speech?: {
+                            mode: "tts" | "asr";
+                            billingMode?: "token_io" | "inference_chars" | "inference_hour" | "realtime_duplex";
+                        };
+                        embedding?: {
+                            contextWindow?: number;
+                            dimensions?: number;
+                            maxInputTokens?: number;
+                            maxBatchSize?: number;
+                            normalization?: "l2" | "none";
+                        };
+                        webSearchDetail?: {
+                            maxResults?: number;
+                        };
+                        thinking?: boolean;
+                        structuredOutput?: boolean;
+                        contextCache?: boolean;
+                        onlineInference?: boolean;
+                        lowLatencyInference?: boolean;
+                        batchInference?: boolean;
+                        fineTuning?: boolean;
+                        toolUse?: boolean;
+                        webSearch?: boolean;
+                        knowledgeBase?: boolean;
+                        mcp?: boolean;
+                    };
+                    status?: "active" | "deprecated";
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            update: {
+                post: (body: {
+                    profileId: string;
+                    referenceVendor?: string;
+                    name?: string;
+                    family?: string;
+                    tags?: string[];
+                    description?: string;
+                    capabilities?: {
+                        productLine?: "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                        inputTypes: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d"[];
+                        outputType: "text" | "image" | "audio" | "video" | "embedding" | "mesh_3d";
+                        rateLimits?: {
+                            tpmPerMinute?: number;
+                            rpmPerMinute?: number;
+                            qpmPerMinute?: number;
+                            ipmPerMinute?: number;
+                            maxConcurrency?: number;
+                        };
+                        text?: {
+                            contextWindow?: number;
+                            maxInputTokens?: number;
+                            maxOutputTokens?: number;
+                            maxThinkingTokens?: number;
+                        };
+                        image?: {
+                            minWidth?: number;
+                            minHeight?: number;
+                            maxWidth?: number;
+                            maxHeight?: number;
+                            maxImagesPerRequest?: number;
+                            supportedAspectRatios?: string[];
+                            supportsInpainting?: boolean;
+                        };
+                        video?: {
+                            supportedResolutions?: string[];
+                            maxFps?: number;
+                            maxDurationSeconds?: number;
+                            minDurationSeconds?: number;
+                            supportedAspectRatios?: string[];
+                            supportsImageToVideo?: boolean;
+                            supportsVideoExtend?: boolean;
+                        };
+                        mesh3d?: {
+                            supportsImageTo3d?: boolean;
+                            outputFormats?: string[];
+                            maxPolygons?: number;
+                        };
+                        speech?: {
+                            mode: "tts" | "asr";
+                            billingMode?: "token_io" | "inference_chars" | "inference_hour" | "realtime_duplex";
+                        };
+                        embedding?: {
+                            contextWindow?: number;
+                            dimensions?: number;
+                            maxInputTokens?: number;
+                            maxBatchSize?: number;
+                            normalization?: "l2" | "none";
+                        };
+                        webSearchDetail?: {
+                            maxResults?: number;
+                        };
+                        thinking?: boolean;
+                        structuredOutput?: boolean;
+                        contextCache?: boolean;
+                        onlineInference?: boolean;
+                        lowLatencyInference?: boolean;
+                        batchInference?: boolean;
+                        fineTuning?: boolean;
+                        toolUse?: boolean;
+                        webSearch?: boolean;
+                        knowledgeBase?: boolean;
+                        mcp?: boolean;
+                    };
+                    status?: "active" | "deprecated";
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            delete: {
+                post: (body: {
+                    profileId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        offerings: {
+            supplierOptions: {
+                /** 管理后台筛选用供应商全量（key/label） */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+            profileOptions: {
+                /** 管理后台筛选用模型信息全量（key/label） */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+            modelOptions: {
+                /** 管理后台筛选用计费标识全量（key/label/value，支持联动筛选） */
+                post: (body: {
+                    supplierId?: string;
+                    profileId?: string;
+                    protocolId?: string;
+                    tag?: string;
+                    enabled?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        models: {
+            find: {
+                post: (body: {
+                    page?: number;
+                    pageSize?: number;
+                    profileId?: string;
+                    referenceVendor?: string;
+                    supplierId?: string;
+                    supplierKind?: "agent_vendor" | "agent_proxy";
+                    protocolId?: string;
+                    tag?: string;
+                    productLine?: "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                    keyword?: string;
+                    enabled?: boolean;
+                    platformAvailable?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            unconfigured: {
+                post: (body: {
+                    supplierId?: string;
+                    supplierKind?: "agent_vendor" | "agent_proxy";
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            create: {
+                post: (body: {
+                    profileId: string;
+                    supplierId: string;
+                    protocolId: string;
+                    providerModelId: string;
+                    name?: string;
+                    version?: string;
+                    status?: "active" | "deprecated";
+                    enabled?: boolean;
+                    description?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            update: {
+                post: (body: {
+                    modelId: string;
+                    supplierId?: string;
+                    profileId?: string;
+                    protocolId?: string;
+                    providerModelId?: string;
+                    name?: string;
+                    version?: string;
+                    status?: "active" | "deprecated";
+                    enabled?: boolean;
+                    description?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            delete: {
+                post: (body: {
+                    modelId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        chat: {
+            supplierOptions: {
+                /** 获取下游应用对话模型设置可用的供应商（与 Ones 已启用 aiSupplier 列表一致） */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+            modelOptions: {
+                /** 获取下游应用可用的对话模型目录项（已启用 text_generation） */
+                post: (body: {
+                    supplierIds?: string[];
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            integrationExport: {
+                /** 按 offeringModelId 生成 LLMConfig 片段与下游 API 说明，供 Ones 复制或调试 */
+                post: (body: {
+                    offeringModelId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            reloadRuntime: {
+                /** 目录或 Key 变更后，从 Mongo 重新编译 /agent/* 可用模型（无需重启进程） */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        prompt: {
+            supplierOptions: {
+                /** Prompt 模块：筛选平台 Runtime 已就绪的文本模型供应商 */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+            modelOptions: {
+                /** Prompt 模块：从平台 Runtime 目录筛选文本模型（offering modelId + providerModelId） */
+                post: (body: {
+                    supplierIds?: string[];
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    billingCatalog: {
+        suppliers: {
+            list: {
+                /** 获取 AI 模型供应商列表 */
+                post: (body: {
+                    enabledOnly?: boolean;
+                    supplierKind?: "agent_vendor" | "agent_proxy";
+                    agentVendorOnly?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        models: {
+            find: {
+                post: (body: {
+                    page?: number;
+                    pageSize?: number;
+                    supplierId?: string;
+                    profileId?: string;
+                    protocolId?: string;
+                    tag?: string;
+                    keyword?: string;
+                    enabled?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        billingEntries: {
+            list: {
+                /** 按 supplier+profile 聚合的价表列表 */
+                post: (body: {
+                    page?: number;
+                    pageSize?: number;
+                    supplierId?: string;
+                    profileId?: string;
+                    productLine?: "" | "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                    keyword?: string;
+                    pricingConfigured?: boolean;
+                    billable?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            unconfigured: {
+                post: (body: {
+                    supplierId?: string;
+                    productLine?: "" | "text" | "multimodal" | "image_gen" | "video_gen" | "mesh_3d" | "embedding" | "speech_tts" | "speech_voice_clone" | "speech_voice_design" | "speech_asr_file" | "speech_asr_stream" | "speech_si" | "speech_realtime_duplex";
+                    keyword?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            get: {
+                post: (body: {
+                    supplierId: string;
+                    profileId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            statuses: {
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        modelPricing: {
+            delete: {
+                post: (body: {
+                    supplierId: string;
+                    profileId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        builtinServices: {
+            list: {
+                /** 只读内置 serviceKey 与 chargeMethodKey catalog */
+                post: (body: {
+                    group?: "ai" | "storage" | "platform";
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        exchangeRate: {
+            get: {
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+            update: {
+                post: (body: {
+                    usdToCny: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    embeddings: {
+        create: {
+            /** 将文本转换为向量（豆包 doubao-embedding-vision-250615），含计费 */
+            post: (body: {
+                model?: string;
+                input: string;
+                dimensions?: number;
+                instructions?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            /** 删除向量生成任务记录 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        find: {
+            /** 分页查询向量生成任务 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    input?: string;
+                    supplierId?: string;
+                    model?: string;
+                    status?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            /** 查询单条向量生成任务 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        options: {
+            status: {
+                /** 获取向量任务状态下拉选项 */
+                post: (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>;
         };
     };
 }