uapi-browser-sdk 0.1.0

package/internal/src/apis/TranslateApi.ts

@@ -0,0 +1,436 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * UAPI
+ * UAPI 官方接口文档
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+import type {
+  GetAiTranslateLanguages200Response,
+  PostAiTranslate200Response,
+  PostAiTranslate400Response,
+  PostAiTranslate401Response,
+  PostAiTranslate429Response,
+  PostAiTranslate500Response,
+  PostAiTranslateRequest,
+  PostTranslateText200Response,
+  PostTranslateText400Response,
+  PostTranslateText500Response,
+  PostTranslateTextRequest,
+} from '../models/index';
+import {
+    GetAiTranslateLanguages200ResponseFromJSON,
+    GetAiTranslateLanguages200ResponseToJSON,
+    PostAiTranslate200ResponseFromJSON,
+    PostAiTranslate200ResponseToJSON,
+    PostAiTranslate400ResponseFromJSON,
+    PostAiTranslate400ResponseToJSON,
+    PostAiTranslate401ResponseFromJSON,
+    PostAiTranslate401ResponseToJSON,
+    PostAiTranslate429ResponseFromJSON,
+    PostAiTranslate429ResponseToJSON,
+    PostAiTranslate500ResponseFromJSON,
+    PostAiTranslate500ResponseToJSON,
+    PostAiTranslateRequestFromJSON,
+    PostAiTranslateRequestToJSON,
+    PostTranslateText200ResponseFromJSON,
+    PostTranslateText200ResponseToJSON,
+    PostTranslateText400ResponseFromJSON,
+    PostTranslateText400ResponseToJSON,
+    PostTranslateText500ResponseFromJSON,
+    PostTranslateText500ResponseToJSON,
+    PostTranslateTextRequestFromJSON,
+    PostTranslateTextRequestToJSON,
+} from '../models/index';
+
+export interface PostAiTranslateOperationRequest {
+    targetLang: PostAiTranslateOperationTargetLangEnum;
+    postAiTranslateRequest: PostAiTranslateRequest;
+}
+
+export interface PostTranslateTextOperationRequest {
+    toLang: PostTranslateTextOperationToLangEnum;
+    postTranslateTextRequest: PostTranslateTextRequest;
+}
+
+/**
+ * 
+ */
+export class TranslateApi extends runtime.BaseAPI {
+
+    /**
+     * 获取AI智能翻译服务支持的完整语言列表、翻译风格选项、上下文场景选项以及性能指标信息。这个接口对于需要在前端动态展示翻译配置选项的应用非常有用，它会返回当前AI翻译服务所支持的所有语言代码、原生名称、翻译风格说明、上下文场景描述，以及服务的性能特征和限制信息。通过此接口，开发者可以构建用户友好的翻译界面，让用户选择合适的翻译参数。
+     * 获取AI翻译支持的语言和配置
+     */
+    async getAiTranslateLanguagesRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetAiTranslateLanguages200Response>> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/ai/translate/languages`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetAiTranslateLanguages200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 获取AI智能翻译服务支持的完整语言列表、翻译风格选项、上下文场景选项以及性能指标信息。这个接口对于需要在前端动态展示翻译配置选项的应用非常有用，它会返回当前AI翻译服务所支持的所有语言代码、原生名称、翻译风格说明、上下文场景描述，以及服务的性能特征和限制信息。通过此接口，开发者可以构建用户友好的翻译界面，让用户选择合适的翻译参数。
+     * 获取AI翻译支持的语言和配置
+     */
+    async getAiTranslateLanguages(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetAiTranslateLanguages200Response> {
+        const response = await this.getAiTranslateLanguagesRaw(initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 这是一个商业级的AI智能翻译服务，采用最新的神经网络翻译技术和大语言模型，提供远超传统机器翻译的质量。它不仅能够智能处理单个文本翻译，还支持高效的批量文本翻译，并且具备上下文感知、风格适配、格式保留等高级功能。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者深度集成和测试。未来，它将转为付费API，为用户提供更稳定、更智能的翻译服务。  ## 功能概述  - **智能双模式**: 支持单个文本翻译和批量文本翻译的统一接口设计，自动识别请求类型并提供相应的翻译服务。系统会根据输入自动判断是处理单条文本还是批量文本，无需使用不同的接口。 - **多风格适配**: 提供随意口语化、专业商务、学术正式、文学艺术四种翻译风格，能够根据不同场景需求调整翻译的语言风格和表达方式。 - **上下文感知**: 支持通用、商务、技术、医疗、法律、市场营销、娱乐、教育、新闻等九种专业领域的上下文翻译，确保术语准确性和表达地道性。 - **高质量保证**: 内置质量评估系统，对每次翻译结果进行流畅度、准确度、完整性评分，并提供置信度分数和替代翻译建议。 - **智能解释**: 提供关键词组翻译注释、文化背景说明和语法结构分析，帮助用户理解翻译逻辑和文化差异。 - **高效批量**: 批量翻译支持最多50条文本，总计10万字符，配备智能并发控制（1-10并发）和失败重试机制。 - **快速模式**: 提供快速模式选项，在保证95%+准确率的前提下，响应时间缩短至800ms内，适合实时翻译和聊天应用。 - **格式保留**: 智能识别并保持原文的格式结构，包括换行、缩进、特殊符号等，确保翻译后的文本保持良好的可读性。
+     * AI智能翻译
+     */
+    async postAiTranslateRaw(requestParameters: PostAiTranslateOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostAiTranslate200Response>> {
+        if (requestParameters['targetLang'] == null) {
+            throw new runtime.RequiredError(
+                'targetLang',
+                'Required parameter "targetLang" was null or undefined when calling postAiTranslate().'
+            );
+        }
+
+        if (requestParameters['postAiTranslateRequest'] == null) {
+            throw new runtime.RequiredError(
+                'postAiTranslateRequest',
+                'Required parameter "postAiTranslateRequest" was null or undefined when calling postAiTranslate().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['targetLang'] != null) {
+            queryParameters['target_lang'] = requestParameters['targetLang'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+
+        let urlPath = `/ai/translate`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: PostAiTranslateRequestToJSON(requestParameters['postAiTranslateRequest']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PostAiTranslate200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 这是一个商业级的AI智能翻译服务，采用最新的神经网络翻译技术和大语言模型，提供远超传统机器翻译的质量。它不仅能够智能处理单个文本翻译，还支持高效的批量文本翻译，并且具备上下文感知、风格适配、格式保留等高级功能。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者深度集成和测试。未来，它将转为付费API，为用户提供更稳定、更智能的翻译服务。  ## 功能概述  - **智能双模式**: 支持单个文本翻译和批量文本翻译的统一接口设计，自动识别请求类型并提供相应的翻译服务。系统会根据输入自动判断是处理单条文本还是批量文本，无需使用不同的接口。 - **多风格适配**: 提供随意口语化、专业商务、学术正式、文学艺术四种翻译风格，能够根据不同场景需求调整翻译的语言风格和表达方式。 - **上下文感知**: 支持通用、商务、技术、医疗、法律、市场营销、娱乐、教育、新闻等九种专业领域的上下文翻译，确保术语准确性和表达地道性。 - **高质量保证**: 内置质量评估系统，对每次翻译结果进行流畅度、准确度、完整性评分，并提供置信度分数和替代翻译建议。 - **智能解释**: 提供关键词组翻译注释、文化背景说明和语法结构分析，帮助用户理解翻译逻辑和文化差异。 - **高效批量**: 批量翻译支持最多50条文本，总计10万字符，配备智能并发控制（1-10并发）和失败重试机制。 - **快速模式**: 提供快速模式选项，在保证95%+准确率的前提下，响应时间缩短至800ms内，适合实时翻译和聊天应用。 - **格式保留**: 智能识别并保持原文的格式结构，包括换行、缩进、特殊符号等，确保翻译后的文本保持良好的可读性。
+     * AI智能翻译
+     */
+    async postAiTranslate(requestParameters: PostAiTranslateOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PostAiTranslate200Response> {
+        const response = await this.postAiTranslateRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 需要跨越语言的鸿沟进行交流？这个翻译接口是你可靠的\'同声传译\'。  ## 功能概述 你可以将一段源语言文本（我们能自动检测源语言）翻译成你指定的任何目标语言。无论是中译英、日译法，都不在话下。  ## 支持的语言 我们支持超过100种语言的互译，包括但不限于：中文（简体/繁体）、英语、日语、韩语、法语、德语、西班牙语、俄语、阿拉伯语等主流语言，以及各种小语种。详见下方参数列表。
+     * 多语言文本翻译
+     */
+    async postTranslateTextRaw(requestParameters: PostTranslateTextOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostTranslateText200Response>> {
+        if (requestParameters['toLang'] == null) {
+            throw new runtime.RequiredError(
+                'toLang',
+                'Required parameter "toLang" was null or undefined when calling postTranslateText().'
+            );
+        }
+
+        if (requestParameters['postTranslateTextRequest'] == null) {
+            throw new runtime.RequiredError(
+                'postTranslateTextRequest',
+                'Required parameter "postTranslateTextRequest" was null or undefined when calling postTranslateText().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['toLang'] != null) {
+            queryParameters['to_lang'] = requestParameters['toLang'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+
+        let urlPath = `/translate/text`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: PostTranslateTextRequestToJSON(requestParameters['postTranslateTextRequest']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PostTranslateText200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 需要跨越语言的鸿沟进行交流？这个翻译接口是你可靠的\'同声传译\'。  ## 功能概述 你可以将一段源语言文本（我们能自动检测源语言）翻译成你指定的任何目标语言。无论是中译英、日译法，都不在话下。  ## 支持的语言 我们支持超过100种语言的互译，包括但不限于：中文（简体/繁体）、英语、日语、韩语、法语、德语、西班牙语、俄语、阿拉伯语等主流语言，以及各种小语种。详见下方参数列表。
+     * 多语言文本翻译
+     */
+    async postTranslateText(requestParameters: PostTranslateTextOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PostTranslateText200Response> {
+        const response = await this.postTranslateTextRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}
+
+/**
+ * @export
+ */
+export const PostAiTranslateOperationTargetLangEnum = {
+    Sq: 'sq',
+    Ga: 'ga',
+    Et: 'et',
+    Ar: 'ar',
+    Am: 'am',
+    Az: 'az',
+    Be: 'be',
+    Bg: 'bg',
+    Eu: 'eu',
+    Is: 'is',
+    Pl: 'pl',
+    BsLatn: 'bs-Latn',
+    Fa: 'fa',
+    Da: 'da',
+    De: 'de',
+    Ru: 'ru',
+    Fr: 'fr',
+    Tl: 'tl',
+    Fi: 'fi',
+    Fy: 'fy',
+    Km: 'km',
+    Ka: 'ka',
+    Gu: 'gu',
+    Ht: 'ht',
+    Ko: 'ko',
+    Ha: 'ha',
+    Kk: 'kk',
+    Nl: 'nl',
+    Gl: 'gl',
+    Ca: 'ca',
+    Cs: 'cs',
+    Ky: 'ky',
+    Kn: 'kn',
+    Tlh: 'tlh',
+    Hr: 'hr',
+    Otq: 'otq',
+    Co: 'co',
+    Ku: 'ku',
+    La: 'la',
+    Lo: 'lo',
+    Lv: 'lv',
+    Lt: 'lt',
+    Ro: 'ro',
+    Lb: 'lb',
+    Mg: 'mg',
+    Mt: 'mt',
+    Mr: 'mr',
+    Ms: 'ms',
+    Ml: 'ml',
+    Mi: 'mi',
+    Mk: 'mk',
+    Mn: 'mn',
+    Bn: 'bn',
+    My: 'my',
+    Mww: 'mww',
+    Hmn: 'hmn',
+    Xh: 'xh',
+    Zu: 'zu',
+    Ne: 'ne',
+    False: 'false',
+    Pa: 'pa',
+    Ps: 'ps',
+    Pt: 'pt',
+    Ny: 'ny',
+    Ja: 'ja',
+    Sv: 'sv',
+    SrLatn: 'sr-Latn',
+    SrCyrl: 'sr-Cyrl',
+    St: 'st',
+    Sm: 'sm',
+    Si: 'si',
+    Eo: 'eo',
+    Sk: 'sk',
+    Sl: 'sl',
+    Sw: 'sw',
+    Gd: 'gd',
+    So: 'so',
+    Ceb: 'ceb',
+    Te: 'te',
+    Ta: 'ta',
+    Th: 'th',
+    Tg: 'tg',
+    Tr: 'tr',
+    Cy: 'cy',
+    ZhLzh: 'zh-lzh',
+    Ur: 'ur',
+    Uk: 'uk',
+    Uz: 'uz',
+    Haw: 'haw',
+    Es: 'es',
+    He: 'he',
+    El: 'el',
+    Sd: 'sd',
+    Hu: 'hu',
+    Sn: 'sn',
+    Hy: 'hy',
+    Ig: 'ig',
+    It: 'it',
+    Yi: 'yi',
+    Hi: 'hi',
+    Id: 'id',
+    En: 'en',
+    Su: 'su',
+    Jw: 'jw',
+    Yua: 'yua',
+    Yo: 'yo',
+    Vi: 'vi',
+    ZhChs: 'zh-CHS',
+    ZhCht: 'zh-CHT'
+} as const;
+export type PostAiTranslateOperationTargetLangEnum = typeof PostAiTranslateOperationTargetLangEnum[keyof typeof PostAiTranslateOperationTargetLangEnum];
+/**
+ * @export
+ */
+export const PostTranslateTextOperationToLangEnum = {
+    Sq: 'sq',
+    Ga: 'ga',
+    Et: 'et',
+    Ar: 'ar',
+    Am: 'am',
+    Az: 'az',
+    Be: 'be',
+    Bg: 'bg',
+    Eu: 'eu',
+    Is: 'is',
+    Pl: 'pl',
+    BsLatn: 'bs-Latn',
+    Fa: 'fa',
+    Da: 'da',
+    De: 'de',
+    Ru: 'ru',
+    Fr: 'fr',
+    Tl: 'tl',
+    Fi: 'fi',
+    Fy: 'fy',
+    Km: 'km',
+    Ka: 'ka',
+    Gu: 'gu',
+    Ht: 'ht',
+    Ko: 'ko',
+    Ha: 'ha',
+    Kk: 'kk',
+    Nl: 'nl',
+    Gl: 'gl',
+    Ca: 'ca',
+    Cs: 'cs',
+    Ky: 'ky',
+    Kn: 'kn',
+    Tlh: 'tlh',
+    Hr: 'hr',
+    Otq: 'otq',
+    Co: 'co',
+    Ku: 'ku',
+    La: 'la',
+    Lo: 'lo',
+    Lv: 'lv',
+    Lt: 'lt',
+    Ro: 'ro',
+    Lb: 'lb',
+    Mg: 'mg',
+    Mt: 'mt',
+    Mr: 'mr',
+    Ms: 'ms',
+    Ml: 'ml',
+    Mi: 'mi',
+    Mk: 'mk',
+    Mn: 'mn',
+    Bn: 'bn',
+    My: 'my',
+    Mww: 'mww',
+    Hmn: 'hmn',
+    Xh: 'xh',
+    Zu: 'zu',
+    Ne: 'ne',
+    False: 'false',
+    Pa: 'pa',
+    Ps: 'ps',
+    Pt: 'pt',
+    Ny: 'ny',
+    Ja: 'ja',
+    Sv: 'sv',
+    SrLatn: 'sr-Latn',
+    SrCyrl: 'sr-Cyrl',
+    St: 'st',
+    Sm: 'sm',
+    Si: 'si',
+    Eo: 'eo',
+    Sk: 'sk',
+    Sl: 'sl',
+    Sw: 'sw',
+    Gd: 'gd',
+    So: 'so',
+    Ceb: 'ceb',
+    Te: 'te',
+    Ta: 'ta',
+    Th: 'th',
+    Tg: 'tg',
+    Tr: 'tr',
+    Cy: 'cy',
+    ZhLzh: 'zh-lzh',
+    Ur: 'ur',
+    Uk: 'uk',
+    Uz: 'uz',
+    Haw: 'haw',
+    Es: 'es',
+    He: 'he',
+    El: 'el',
+    Sd: 'sd',
+    Hu: 'hu',
+    Sn: 'sn',
+    Hy: 'hy',
+    Ig: 'ig',
+    It: 'it',
+    Yi: 'yi',
+    Hi: 'hi',
+    Id: 'id',
+    En: 'en',
+    Su: 'su',
+    Jw: 'jw',
+    Yua: 'yua',
+    Yo: 'yo',
+    Vi: 'vi',
+    ZhChs: 'zh-CHS',
+    ZhCht: 'zh-CHT'
+} as const;
+export type PostTranslateTextOperationToLangEnum = typeof PostTranslateTextOperationToLangEnum[keyof typeof PostTranslateTextOperationToLangEnum];

package/internal/src/apis/WebParseApi.ts

@@ -0,0 +1,235 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * UAPI
+ * UAPI 官方接口文档
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+import type {
+  GetImageTobase64400Response,
+  GetWebTomarkdownAsyncStatus200Response,
+  GetWebTomarkdownAsyncStatus404Response,
+  GetWebparseExtractimages200Response,
+  GetWebparseExtractimages500Response,
+  GetWebparseMetadata200Response,
+  GetWebparseMetadata500Response,
+  PostWebTomarkdownAsync202Response,
+  PostWebTomarkdownAsync400Response,
+} from '../models/index';
+import {
+    GetImageTobase64400ResponseFromJSON,
+    GetImageTobase64400ResponseToJSON,
+    GetWebTomarkdownAsyncStatus200ResponseFromJSON,
+    GetWebTomarkdownAsyncStatus200ResponseToJSON,
+    GetWebTomarkdownAsyncStatus404ResponseFromJSON,
+    GetWebTomarkdownAsyncStatus404ResponseToJSON,
+    GetWebparseExtractimages200ResponseFromJSON,
+    GetWebparseExtractimages200ResponseToJSON,
+    GetWebparseExtractimages500ResponseFromJSON,
+    GetWebparseExtractimages500ResponseToJSON,
+    GetWebparseMetadata200ResponseFromJSON,
+    GetWebparseMetadata200ResponseToJSON,
+    GetWebparseMetadata500ResponseFromJSON,
+    GetWebparseMetadata500ResponseToJSON,
+    PostWebTomarkdownAsync202ResponseFromJSON,
+    PostWebTomarkdownAsync202ResponseToJSON,
+    PostWebTomarkdownAsync400ResponseFromJSON,
+    PostWebTomarkdownAsync400ResponseToJSON,
+} from '../models/index';
+
+export interface GetWebTomarkdownAsyncStatusRequest {
+    taskId: string;
+}
+
+export interface GetWebparseExtractimagesRequest {
+    url: string;
+}
+
+export interface GetWebparseMetadataRequest {
+    url: string;
+}
+
+export interface PostWebTomarkdownAsyncRequest {
+    url: string;
+}
+
+/**
+ * 
+ */
+export class WebParseApi extends runtime.BaseAPI {
+
+    /**
+     * 提交了URL转Markdown任务后，想知道处理进度和结果？这个接口可以帮你实时追踪。  ## 功能概述  通过之前提交任务时获得的任务ID，你可以查询该任务的当前状态、处理进度以及最终结果。任务结果会在缓存中保存30分钟，期间可以重复查询，非常方便。  任务有五种状态：等待处理（pending）时进度为0%；处理中（processing）时进度在10-90%之间；已完成（completed）时进度为100%并返回Markdown内容；失败（failed）时会返回错误信息；超时（timeout）表示任务处理时间超过60秒已被取消。建议采用指数退避策略进行轮询，初始延迟1秒，每次延迟增加20%，最大延迟5秒。当状态为已完成、失败或超时时停止轮询。  系统会自动管理任务生命周期，单个任务最长处理时间为60秒，任务结果保存30分钟后自动清理，每5分钟清理一次过期任务。  ## 任务状态说明  | 状态 | 说明 | 进度 | 轮询建议 | |------|------|------|----------| | `pending` | 等待处理 | 0% | 立即开始轮询 | | `processing` | 处理中 | 10-90% | 每2-5秒轮询一次 | | `completed` | 已完成 | 100% | 停止轮询，获取结果 | | `failed` | 失败 | 100% | 停止轮询，查看错误信息 | | `timeout` | 超时 | 100% | 停止轮询，任务已取消 |
+     * 查询网页转换任务状态和结果
+     */
+    async getWebTomarkdownAsyncStatusRaw(requestParameters: GetWebTomarkdownAsyncStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWebTomarkdownAsyncStatus200Response>> {
+        if (requestParameters['taskId'] == null) {
+            throw new runtime.RequiredError(
+                'taskId',
+                'Required parameter "taskId" was null or undefined when calling getWebTomarkdownAsyncStatus().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/web/tomarkdown/async/{task_id}`;
+        urlPath = urlPath.replace(`{${"task_id"}}`, encodeURIComponent(String(requestParameters['taskId'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetWebTomarkdownAsyncStatus200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 提交了URL转Markdown任务后，想知道处理进度和结果？这个接口可以帮你实时追踪。  ## 功能概述  通过之前提交任务时获得的任务ID，你可以查询该任务的当前状态、处理进度以及最终结果。任务结果会在缓存中保存30分钟，期间可以重复查询，非常方便。  任务有五种状态：等待处理（pending）时进度为0%；处理中（processing）时进度在10-90%之间；已完成（completed）时进度为100%并返回Markdown内容；失败（failed）时会返回错误信息；超时（timeout）表示任务处理时间超过60秒已被取消。建议采用指数退避策略进行轮询，初始延迟1秒，每次延迟增加20%，最大延迟5秒。当状态为已完成、失败或超时时停止轮询。  系统会自动管理任务生命周期，单个任务最长处理时间为60秒，任务结果保存30分钟后自动清理，每5分钟清理一次过期任务。  ## 任务状态说明  | 状态 | 说明 | 进度 | 轮询建议 | |------|------|------|----------| | `pending` | 等待处理 | 0% | 立即开始轮询 | | `processing` | 处理中 | 10-90% | 每2-5秒轮询一次 | | `completed` | 已完成 | 100% | 停止轮询，获取结果 | | `failed` | 失败 | 100% | 停止轮询，查看错误信息 | | `timeout` | 超时 | 100% | 停止轮询，任务已取消 |
+     * 查询网页转换任务状态和结果
+     */
+    async getWebTomarkdownAsyncStatus(requestParameters: GetWebTomarkdownAsyncStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetWebTomarkdownAsyncStatus200Response> {
+        const response = await this.getWebTomarkdownAsyncStatusRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想一次性“打包”一个网页上的所有图片吗？这个接口可以帮你实现。  ## 功能概述 你提供一个网页的URL，我们会访问该页面，解析其HTML内容，并提取出所有 `<img>` 标签中的图片链接，然后将这些链接列表返回给你。非常适合用于制作图片采集器或素材下载工具。
+     * 提取网页中的所有图片
+     */
+    async getWebparseExtractimagesRaw(requestParameters: GetWebparseExtractimagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWebparseExtractimages200Response>> {
+        if (requestParameters['url'] == null) {
+            throw new runtime.RequiredError(
+                'url',
+                'Required parameter "url" was null or undefined when calling getWebparseExtractimages().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['url'] != null) {
+            queryParameters['url'] = requestParameters['url'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/webparse/extractimages`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetWebparseExtractimages200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想一次性“打包”一个网页上的所有图片吗？这个接口可以帮你实现。  ## 功能概述 你提供一个网页的URL，我们会访问该页面，解析其HTML内容，并提取出所有 `<img>` 标签中的图片链接，然后将这些链接列表返回给你。非常适合用于制作图片采集器或素材下载工具。
+     * 提取网页中的所有图片
+     */
+    async getWebparseExtractimages(requestParameters: GetWebparseExtractimagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetWebparseExtractimages200Response> {
+        const response = await this.getWebparseExtractimagesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 当你在应用中需要展示一个链接的预览时（就像微信或Telegram里那样），这个接口能帮你轻松获取所需信息。  ## 功能概述 你提供一个网页的URL，我们会抓取并解析它的 `<head>` 部分，提取出关键的元数据（Metadata），如页面标题（Title）、描述（Description）、关键词（Keywords）以及网站图标（Favicon）等。
+     * 抓取并解析网页的元数据
+     */
+    async getWebparseMetadataRaw(requestParameters: GetWebparseMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWebparseMetadata200Response>> {
+        if (requestParameters['url'] == null) {
+            throw new runtime.RequiredError(
+                'url',
+                'Required parameter "url" was null or undefined when calling getWebparseMetadata().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['url'] != null) {
+            queryParameters['url'] = requestParameters['url'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/webparse/metadata`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetWebparseMetadata200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 当你在应用中需要展示一个链接的预览时（就像微信或Telegram里那样），这个接口能帮你轻松获取所需信息。  ## 功能概述 你提供一个网页的URL，我们会抓取并解析它的 `<head>` 部分，提取出关键的元数据（Metadata），如页面标题（Title）、描述（Description）、关键词（Keywords）以及网站图标（Favicon）等。
+     * 抓取并解析网页的元数据
+     */
+    async getWebparseMetadata(requestParameters: GetWebparseMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetWebparseMetadata200Response> {
+        const response = await this.getWebparseMetadataRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想要将复杂的网页转换为结构清晰的Markdown？这个接口采用异步处理模式，特别适合处理大型网页、复杂网站或需要长时间处理的转换任务。  ## 功能概述  > [!VIP] >本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  UAPI Pro平台推出的异步网页转Markdown API能够将任意网页URL转换为结构清晰、格式优美的Markdown文本。提交任务后立即返回任务ID，不会阻塞客户端等待。您可以通过任务ID实时查询转换进度和处理状态，支持长达60秒的处理时间，轻松应对大型网站、需要JS渲染的单页应用等复杂页面。任务结果会缓存30分钟，期间可重复查询，过期任务自动清理无需手动管理。  此API采用先进算法，自动识别并抓取网页主体内容，精准剔除广告、导航栏、页眉页脚等无关元素。完美保留原文的格式，包括标题、列表、代码块、表格、引用、图片等，并输出为兼容性强的GitHub Flavored Markdown (GFM) 格式。同时会自动解析并提取文章标题、作者、发布日期、站点名称等关键元数据，并将其格式化为标准的YAML Front Matter，方便后续处理和CMS集成。  ## 使用流程  调用本接口提交URL转换任务后，会立即获得一个唯一的任务ID。随后使用任务ID调用查询接口，获取任务状态和进度。任务完成后，从查询接口的响应中获取Markdown内容。
+     * 深度抓取网页转Markdown
+     */
+    async postWebTomarkdownAsyncRaw(requestParameters: PostWebTomarkdownAsyncRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostWebTomarkdownAsync202Response>> {
+        if (requestParameters['url'] == null) {
+            throw new runtime.RequiredError(
+                'url',
+                'Required parameter "url" was null or undefined when calling postWebTomarkdownAsync().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['url'] != null) {
+            queryParameters['url'] = requestParameters['url'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/web/tomarkdown/async`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PostWebTomarkdownAsync202ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想要将复杂的网页转换为结构清晰的Markdown？这个接口采用异步处理模式，特别适合处理大型网页、复杂网站或需要长时间处理的转换任务。  ## 功能概述  > [!VIP] >本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  UAPI Pro平台推出的异步网页转Markdown API能够将任意网页URL转换为结构清晰、格式优美的Markdown文本。提交任务后立即返回任务ID，不会阻塞客户端等待。您可以通过任务ID实时查询转换进度和处理状态，支持长达60秒的处理时间，轻松应对大型网站、需要JS渲染的单页应用等复杂页面。任务结果会缓存30分钟，期间可重复查询，过期任务自动清理无需手动管理。  此API采用先进算法，自动识别并抓取网页主体内容，精准剔除广告、导航栏、页眉页脚等无关元素。完美保留原文的格式，包括标题、列表、代码块、表格、引用、图片等，并输出为兼容性强的GitHub Flavored Markdown (GFM) 格式。同时会自动解析并提取文章标题、作者、发布日期、站点名称等关键元数据，并将其格式化为标准的YAML Front Matter，方便后续处理和CMS集成。  ## 使用流程  调用本接口提交URL转换任务后，会立即获得一个唯一的任务ID。随后使用任务ID调用查询接口，获取任务状态和进度。任务完成后，从查询接口的响应中获取Markdown内容。
+     * 深度抓取网页转Markdown
+     */
+    async postWebTomarkdownAsync(requestParameters: PostWebTomarkdownAsyncRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PostWebTomarkdownAsync202Response> {
+        const response = await this.postWebTomarkdownAsyncRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}