uapi-browser-sdk 0.1.15 → 0.1.16

package/internal/docs/ImageApi.md

@@ -5,14 +5,17 @@ All URIs are relative to *https://uapis.cn/api/v1*
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
 | [**getAvatarGravatar**](ImageApi.md#getavatargravatar) | **GET** /avatar/gravatar | 获取Gravatar头像 |
-| [**getImageBingDaily**](ImageApi.md#getimagebingdaily) | **GET** /image/bing-daily | 必应壁纸 |
+| [**getImageBingDaily**](ImageApi.md#getimagebingdaily) | **GET** /image/bing-daily | 获取必应每日壁纸 |
+| [**getImageBingDailyHistory**](ImageApi.md#getimagebingdailyhistory) | **GET** /image/bing-daily/history | 查询必应壁纸历史 |
 | [**getImageMotou**](ImageApi.md#getimagemotou) | **GET** /image/motou | 生成摸摸头GIF (QQ号) |
 | [**getImageQrcode**](ImageApi.md#getimageqrcode) | **GET** /image/qrcode | 生成二维码 |
 | [**getImageTobase64**](ImageApi.md#getimagetobase64) | **GET** /image/tobase64 | 图片转 Base64 |
 | [**postImageCompress**](ImageApi.md#postimagecompress) | **POST** /image/compress | 无损压缩图片 |
+| [**postImageDecode**](ImageApi.md#postimagedecode) | **POST** /image/decode | 解码并缩放图片 |
 | [**postImageFrombase64**](ImageApi.md#postimagefrombase64operation) | **POST** /image/frombase64 | 通过Base64编码上传图片 |
 | [**postImageMotou**](ImageApi.md#postimagemotou) | **POST** /image/motou | 生成摸摸头GIF |
 | [**postImageNsfw**](ImageApi.md#postimagensfw) | **POST** /image/nsfw | 图片敏感检测 |
+| [**postImageOcr**](ImageApi.md#postimageocr) | **POST** /image/ocr | 通用 OCR 文字识别 |
 | [**postImageSpeechless**](ImageApi.md#postimagespeechlessoperation) | **POST** /image/speechless | 生成你们怎么不说话了表情包 |
 | [**postImageSvg**](ImageApi.md#postimagesvg) | **POST** /image/svg | SVG转图片 |
 
@@ -24,7 +27,7 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 获取Gravatar头像
 
-提供一个超高速、高可用的Gravatar头像代理服务。内置了强大的ETag条件缓存，确保用户在更新Gravatar头像后能几乎立刻看到变化，同时最大化地利用缓存。
+提供稳定、易用的头像获取能力，适合在网页或应用中直接展示头像。
 
 ### Example
 
@@ -101,11 +104,11 @@ No authorization required
 
 ## getImageBingDaily
 
-> Blob getImageBingDaily()
+> Blob getImageBingDaily(date, resolution, format)
 
-必应壁纸
+获取必应每日壁纸
 
-每天都想换张新壁纸？让必应的美图点亮你的一天吧！  ## 功能概述 这个接口会获取 Bing 搜索引擎当天全球同步的每日壁纸，并直接以图片形式返回。你可以用它来做应用的启动页、网站背景，或者任何需要每日更新精美图片的地方。  ## 使用须知 此接口成功时直接返回图片二进制数据，通常是 `image/jpeg`，不是 JSON 格式。接入时请按图片响应来处理。
+这个接口可以获取最新或指定日期的必应壁纸。默认直接返回图片，也可以传 `format=json` 获取元数据，或者传 `format=redirect` 直接跳转到最终图片地址。  ## 功能概述 - 不传参数时，默认返回当天壁纸图片二进制 - 可以传 `date` 查询指定日期的壁纸 - 可以传 `resolution` 选择 `4k` 或 `1080` - 可以传 `format` 控制返回图片、JSON 或 302 跳转 - 当传 `format=json` 时，返回的是扁平 JSON 对象，里面会包含标题、副标题、说明文案、版权信息、问答信息和图片地址等字段  ## 参数说明 `resolution` 默认是 `4k`。 `format` 默认是 `image`。
 
 ### Example
 
@@ -120,8 +123,17 @@ async function example() {
   console.log("🚀 Testing uapi-browser-sdk-browser SDK...");
   const api = new ImageApi();
 
+  const body = {
+    // string | 壁纸日期，格式是 `YYYY-MM-DD`。不传时返回当天壁纸。 (optional)
+    date: date_example,
+    // '4k' | '1080' | 返回图片的目标分辨率。可以传 `4k` 或 `1080`，不传时默认是 `4k`。 (optional)
+    resolution: 4k,
+    // 'image' | 'json' | 'redirect' | 响应格式。可以传 `image`、`json` 或 `redirect`。不传时默认是 `image`。 (optional)
+    format: format_example,
+  } satisfies GetImageBingDailyRequest;
+
   try {
-    const data = await api.getImageBingDaily();
+    const data = await api.getImageBingDaily(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -134,7 +146,12 @@ example().catch(console.error);
 
 ### Parameters
 
-This endpoint does not need any parameter.
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **date** | `string` | 壁纸日期，格式是 `YYYY-MM-DD`。不传时返回当天壁纸。 | [Optional] [Defaults to `undefined`] |
+| **resolution** | `4k`, `1080` | 返回图片的目标分辨率。可以传 `4k` 或 `1080`，不传时默认是 `4k`。 | [Optional] [Defaults to `'4k'`] [Enum: 4k, 1080] |
+| **format** | `image`, `json`, `redirect` | 响应格式。可以传 `image`、`json` 或 `redirect`。不传时默认是 `image`。 | [Optional] [Defaults to `'image'`] [Enum: image, json, redirect] |
 
 ### Return type
 
@@ -147,14 +164,96 @@ No authorization required
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: `image/*`, `application/json`
+- **Accept**: `image/jpeg`, `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | 请求成功。`format=image` 返回图片二进制，`format=json` 返回壁纸元数据。 |  -  |
+| **302** | 当 &#x60;format&#x3D;redirect&#x60; 时，这个接口会通过 &#x60;Location&#x60; 响应头跳转到最终图片地址。 |  * Location -  <br>  |
+| **400** | 请求参数不正确。 |  -  |
+| **404** | 指定日期没有找到对应的壁纸。 |  -  |
+| **500** | 服务器处理失败，请稍后重试。 |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getImageBingDailyHistory
+
+> GetImageBingDailyHistory200Response getImageBingDailyHistory(date, resolution, page, pageSize)
+
+查询必应壁纸历史
+
+这个接口用于查询必应壁纸历史列表，也可以按日期精确查询某一天。默认按时间倒序返回 JSON。  ## 功能概述 - 可以传 &#x60;date&#x60; 精确查询某一天，命中后只返回 1 条数据 - 不传 &#x60;date&#x60; 时，按时间倒序分页返回历史列表 - 可以传 &#x60;resolution&#x60; 让 &#x60;image_url&#x60; 直接对应 &#x60;4k&#x60; 或 &#x60;1080&#x60; - 可以传 &#x60;page&#x60; 和 &#x60;page_size&#x60; 控制分页 - 每条记录都是扁平 JSON 对象，里面会包含标题、副标题、说明文案、版权信息、问答信息和图片地址等字段  ## 参数说明 &#x60;resolution&#x60; 默认是 &#x60;4k&#x60;。 &#x60;page&#x60; 默认是 &#x60;1&#x60;，&#x60;page_size&#x60; 默认是 &#x60;30&#x60;，最大是 &#x60;100&#x60;。 当传了 &#x60;date&#x60; 以后，&#x60;page&#x60; 和 &#x60;page_size&#x60; 不生效。
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ImageApi,
+} from 'uapi-browser-sdk-browser';
+import type { GetImageBingDailyHistoryRequest } from 'uapi-browser-sdk-browser';
+
+async function example() {
+  console.log("🚀 Testing uapi-browser-sdk-browser SDK...");
+  const api = new ImageApi();
+
+  const body = {
+    // string | 壁纸日期，格式是 `YYYY-MM-DD`。传了以后会按日期精确查询，并且忽略 `page` 和 `page_size`。 (optional)
+    date: 2026-04-05,
+    // '4k' | '1080' | 返回图片的目标分辨率。可以传 `4k` 或 `1080`，不传时默认是 `4k`。 (optional)
+    resolution: 1080,
+    // number | 分页页码，必须是正整数。不传时默认是 `1`。只有在不传 `date` 时才生效。 (optional)
+    page: 2,
+    // number | 每页条数，必须是正整数。不传时默认是 `30`，最大是 `100`。只有在不传 `date` 时才生效。 (optional)
+    pageSize: 10,
+  } satisfies GetImageBingDailyHistoryRequest;
+
+  try {
+    const data = await api.getImageBingDailyHistory(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **date** | `string` | 壁纸日期，格式是 &#x60;YYYY-MM-DD&#x60;。传了以后会按日期精确查询，并且忽略 &#x60;page&#x60; 和 &#x60;page_size&#x60;。 | [Optional] [Defaults to `undefined`] |
+| **resolution** | `4k`, `1080` | 返回图片的目标分辨率。可以传 &#x60;4k&#x60; 或 &#x60;1080&#x60;，不传时默认是 &#x60;4k&#x60;。 | [Optional] [Defaults to `&#39;4k&#39;`] [Enum: 4k, 1080] |
+| **page** | `number` | 分页页码，必须是正整数。不传时默认是 &#x60;1&#x60;。只有在不传 &#x60;date&#x60; 时才生效。 | [Optional] [Defaults to `1`] |
+| **pageSize** | `number` | 每页条数，必须是正整数。不传时默认是 &#x60;30&#x60;，最大是 &#x60;100&#x60;。只有在不传 &#x60;date&#x60; 时才生效。 | [Optional] [Defaults to `30`] |
+
+### Return type
+
+[**GetImageBingDailyHistory200Response**](GetImageBingDailyHistory200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | 请求成功！响应体是JPEG或PNG格式的图片二进制数据。 |  -  |
-| **502** | 上游服务错误。我们无法从必应官方API获取到图片，并且备用图片方案也失败了。请稍后重试。 |  -  |
+| **200** | 查询成功，返回历史壁纸列表和分页信息。 |  -  |
+| **400** | 请求参数不正确。 |  -  |
+| **404** | 按日期精确查询时，没有找到对应的壁纸。 |  -  |
+| **500** | 服务器处理失败，请稍后重试。 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
@@ -308,7 +407,7 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | 请求成功。响应的格式和内容取决于你传入的 &#x60;format&#x60; 参数。请参考下面不同 &#x60;Content-Type&#x60; 的定义。 |  -  |
+| **200** | 请求成功。响应的格式和内容取决于你传入的 &#x60;format&#x60; 参数。请参考下面不同格式的定义。 |  -  |
 | **400** | 请求参数错误。请检查 &#x60;text&#x60; 是否提供，&#x60;size&#x60; 是否在有效范围内，&#x60;format&#x60; 是否为支持的值。 |  -  |
 | **500** | 服务器内部错误。在生成二维码的过程中发生了未知错误。 |  -  |
 
@@ -390,7 +489,7 @@ No authorization required
 
 无损压缩图片
 
-还在为图片体积和加载速度发愁吗？体验一下我们强大的**无损压缩服务**，它能在几乎不牺牲任何肉眼可感知的画质的前提下，将图片体积压缩到极致。  ## 功能概述 你只需要上传一张常见的图片（如 PNG, JPG），选择一个压缩等级，就能获得一个体积小到惊人的压缩文件。这对于需要大量展示高清图片的网站、App 或小程序来说，是优化用户体验、节省带宽和存储成本的利器。  ## 使用须知 &gt; [!TIP] &gt; 为了给您最好的压缩效果，我们的算法需要进行复杂计算，处理时间可能会稍长一些，请耐心等待。  &gt; [!WARNING] &gt; **服务排队提醒** &gt; 这是一个计算密集型服务。在高并发时，您的请求可能会被排队等待处理。如果您需要将其集成到对延迟敏感的生产服务中，请注意这一点。  ### 请求与响应格式 - 请求必须使用 &#x60;multipart/form-data&#x60; 格式上传文件。 - 成功响应将直接返回压缩后的文件二进制流 (&#x60;image/_*&#x60;)，并附带 &#x60;Content-Disposition&#x60; 头，建议客户端根据此头信息保存文件。  ## 参数详解 ### &#x60;level&#x60; (压缩等级) 这是一个从 &#x60;1&#x60; 到 &#x60;5&#x60; 的整数，它决定了压缩的强度和策略，数字越小，压缩率越高。所有等级都经过精心调校，以在最大化压缩率的同时保证出色的视觉质量。 - &#x60;1&#x60;: **极限压缩** (推荐，体积最小，画质优异) - &#x60;2&#x60;: **高效压缩** - &#x60;3&#x60;: **智能均衡** (默认选项) - &#x60;4&#x60;: **画质优先** - &#x60;5&#x60;: **专业保真** (压缩率稍低，保留最多图像信息)  ## 错误处理指南 - **400 Bad Request**: 通常因为没有上传文件，或者 &#x60;level&#x60; 参数不在 1-5 的范围内。 - **500 Internal Server Error**: 如果在压缩过程中服务器发生内部错误，会返回此状态码。
+还在为图片体积和加载速度发愁吗？体验一下我们强大的**无损压缩服务**，它能在几乎不牺牲任何肉眼可感知的画质的前提下，将图片体积压缩到极致。  ## 功能概述 你只需要上传一张常见的图片（如 PNG, JPG），选择一个压缩等级，就能获得一个体积小到惊人的压缩文件。这对于需要大量展示高清图片的网站、App 或小程序来说，是优化用户体验、节省带宽和存储成本的利器。  ## 使用须知 &gt; [!TIP] &gt; 图片越大或压缩等级越高，处理时间可能越长，请您耐心等待。  &gt; [!WARNING] &gt; **处理时间提醒** &gt; 在访问量较高时，处理时间可能进一步延长。如果您的业务对返回时间比较敏感，建议预留充足的处理时间。  ### 请求与响应格式 - 请求必须使用 &#x60;multipart/form-data&#x60; 格式上传文件。 - 成功响应将直接返回压缩后的文件二进制流 (&#x60;image/_*&#x60;)，并附带 &#x60;Content-Disposition&#x60; 头，建议客户端根据此头信息保存文件。  ## 参数详解 ### &#x60;level&#x60; (压缩等级) 这是一个从 &#x60;1&#x60; 到 &#x60;5&#x60; 的整数，它决定了压缩的强度和策略，数字越小，压缩率越高。所有等级都经过精心调校，以在最大化压缩率的同时保证出色的视觉质量。 - &#x60;1&#x60;: **极限压缩** (推荐，体积最小，画质优异) - &#x60;2&#x60;: **高效压缩** - &#x60;3&#x60;: **智能均衡** (默认选项) - &#x60;4&#x60;: **画质优先** - &#x60;5&#x60;: **专业保真** (压缩率稍低，保留最多图像信息)  ## 错误处理指南 - **400 Bad Request**: 通常因为没有上传文件，或者 &#x60;level&#x60; 参数不在 1-5 的范围内。 - **500 Internal Server Error**: 如果在压缩过程中服务器发生内部错误，会返回此状态码。
 
 ### Example
 
@@ -452,13 +551,113 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | 压缩成功响应。响应是压缩后的图片二进制数据。&#x60;Content-Type&#x60; 依据选择的目标格式，默认为 image/png。 |  * Content-Disposition - 提示客户端文件下载为压缩后的文件。建议扩展名与输出格式一致。 <br>  |
+| **200** | 压缩成功响应。响应是压缩后的图片二进制数据。返回格式会依据你选择的目标格式变化，默认是 PNG 图片数据。 |  * Content-Disposition - 提示客户端文件下载为压缩后的文件。建议扩展名与输出格式一致。 <br>  |
 | **400** | 请求无效。可能是未上传文件、文件格式不受支持或参数错误。 |  -  |
 | **500** | 服务器内部错误。压缩过程中发生错误。 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## postImageDecode
+
+> Blob postImageDecode(width, height, maxWidth, maxHeight, format, colorMode, fit, background, file, url)
+
+解码并缩放图片
+
+在 RAM 和 Flash 极其有限的设备上解码图片是一项繁重的任务。这个接口专为 IoT 和嵌入式开发设计，将复杂的图像解码和缩放操作转移到云端，直接输出适用于单片机屏幕的二进制像素流。  ## 功能概述 此接口提供了灵活的云端图像预处理能力，帮助硬件开发者跳过繁琐的图像处理逻辑： - **直接推流渲染**：如果选择输出纯像素流（如 RGB565），单片机收到网络数据后无需解析文件头，可直接将其写入显存，实现极低内存占用的边下边播。 - **完美适配屏幕**：无需在设备端编写裁剪或补边代码。只需传入目标屏幕的物理分辨率，接口会自动完成等比缩放、居中补色或铺满裁剪，确保最终显示画面不变形。 - **精准内存分配**：在动态缩放图片的场景下，服务端会在 HTTP 响应头中提前注入 &#x60;X-Image-Width&#x60; 和 &#x60;X-Image-Height&#x60;，方便设备在读取真实的二进制数据前进行准确的内存分配。  ## 使用须知 - **请求格式**：无论是上传本地文件还是传递图片链接，请求体都必须使用 &#x60;multipart/form-data&#x60; 编码格式。 - **网络资源获取**：当您选择传递图片链接时，服务端会自动尝试获取该资源。请确保您提供的图片链接是公网直接可访问的，且不需要任何形式的登录鉴权。
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ImageApi,
+} from 'uapi-browser-sdk-browser';
+import type { PostImageDecodeRequest } from 'uapi-browser-sdk-browser';
+
+async function example() {
+  console.log("🚀 Testing uapi-browser-sdk-browser SDK...");
+  const api = new ImageApi();
+
+  const body = {
+    // number | 目标宽度，单位是像素。可以单独传，也可以和 `height` 一起传。与 `max_width`、`max_height` 互斥。 (optional)
+    width: 56,
+    // number | 目标高度，单位是像素。可以单独传，也可以和 `width` 一起传。与 `max_width`、`max_height` 互斥。 (optional)
+    height: 56,
+    // number | 最大宽度，单位是像素。只有在不传 `width`、`height` 时才生效，会按原比例缩放。 (optional)
+    maxWidth: 56,
+    // number | 最大高度，单位是像素。只有在不传 `width`、`height` 时才生效，会按原比例缩放。 (optional)
+    maxHeight: 56,
+    // 'bmp' | 'rgb565' | 'rgb888' | 输出格式。可以传 `bmp`、`rgb565` 或 `rgb888`，不传时默认是 `bmp`。 (optional)
+    format: format_example,
+    // 'RGB565' | 'RGB888' | BMP 输出的颜色模式。只有在 `format=bmp` 时才生效，可以传 `RGB565` 或 `RGB888`，不传时默认是 `RGB888`。 (optional)
+    colorMode: colorMode_example,
+    // 'contain' | 'cover' | 'fill' | 缩放模式。可以传 `contain`、`cover` 或 `fill`，不传时默认是 `contain`。当传 `cover` 或 `fill` 时，`width` 和 `height` 都要传。 (optional)
+    fit: fit_example,
+    // string | 背景色。可以传 `black`、`white` 或 `#RRGGBB`，不传时默认是 `black`。 (optional)
+    background: background_example,
+    // Blob | 要处理的图片文件。这个接口适合直接上传 JPG、JPEG、PNG、WebP、BMP 等常见格式。 (optional)
+    file: BINARY_DATA_HERE,
+    // string | 要处理的图片链接。适合不方便直接上传文件时使用。 (optional)
+    url: url_example,
+  } satisfies PostImageDecodeRequest;
+
+  try {
+    const data = await api.postImageDecode(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **width** | `number` | 目标宽度，单位是像素。可以单独传，也可以和 &#x60;height&#x60; 一起传。与 &#x60;max_width&#x60;、&#x60;max_height&#x60; 互斥。 | [Optional] [Defaults to `undefined`] |
+| **height** | `number` | 目标高度，单位是像素。可以单独传，也可以和 &#x60;width&#x60; 一起传。与 &#x60;max_width&#x60;、&#x60;max_height&#x60; 互斥。 | [Optional] [Defaults to `undefined`] |
+| **maxWidth** | `number` | 最大宽度，单位是像素。只有在不传 &#x60;width&#x60;、&#x60;height&#x60; 时才生效，会按原比例缩放。 | [Optional] [Defaults to `undefined`] |
+| **maxHeight** | `number` | 最大高度，单位是像素。只有在不传 &#x60;width&#x60;、&#x60;height&#x60; 时才生效，会按原比例缩放。 | [Optional] [Defaults to `undefined`] |
+| **format** | `bmp`, `rgb565`, `rgb888` | 输出格式。可以传 &#x60;bmp&#x60;、&#x60;rgb565&#x60; 或 &#x60;rgb888&#x60;，不传时默认是 &#x60;bmp&#x60;。 | [Optional] [Defaults to `&#39;bmp&#39;`] [Enum: bmp, rgb565, rgb888] |
+| **colorMode** | `RGB565`, `RGB888` | BMP 输出的颜色模式。只有在 &#x60;format&#x3D;bmp&#x60; 时才生效，可以传 &#x60;RGB565&#x60; 或 &#x60;RGB888&#x60;，不传时默认是 &#x60;RGB888&#x60;。 | [Optional] [Defaults to `&#39;RGB888&#39;`] [Enum: RGB565, RGB888] |
+| **fit** | `contain`, `cover`, `fill` | 缩放模式。可以传 &#x60;contain&#x60;、&#x60;cover&#x60; 或 &#x60;fill&#x60;，不传时默认是 &#x60;contain&#x60;。当传 &#x60;cover&#x60; 或 &#x60;fill&#x60; 时，&#x60;width&#x60; 和 &#x60;height&#x60; 都要传。 | [Optional] [Defaults to `&#39;contain&#39;`] [Enum: contain, cover, fill] |
+| **background** | `string` | 背景色。可以传 &#x60;black&#x60;、&#x60;white&#x60; 或 &#x60;#RRGGBB&#x60;，不传时默认是 &#x60;black&#x60;。 | [Optional] [Defaults to `&#39;black&#39;`] |
+| **file** | `Blob` | 要处理的图片文件。这个接口适合直接上传 JPG、JPEG、PNG、WebP、BMP 等常见格式。 | [Optional] [Defaults to `undefined`] |
+| **url** | `string` | 要处理的图片链接。适合不方便直接上传文件时使用。 | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+**Blob**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `multipart/form-data`
+- **Accept**: `image/bmp`, `application/octet-stream`, `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | 处理成功，直接返回图片二进制数据。&#x60;format&#x3D;bmp&#x60; 时返回 BMP 图片数据，&#x60;format&#x3D;rgb565&#x60; 或 &#x60;rgb888&#x60; 时返回原始二进制像素数据。 |  * X-Image-Width - 输出图片的实际宽度（像素）。 <br>  * X-Image-Height - 输出图片的实际高度（像素）。 <br>  * X-Output-Format - 本次响应使用的输出格式。 <br>  * X-Color-Mode - 本次响应使用的颜色模式。 <br>  * X-Source-Format - 源图片识别出的格式。 <br>  * X-Byte-Order - 当输出使用 16 位像素数据时返回字节序信息。 <br>  |
+| **400** | 请求参数不正确，或者传入的文件和链接都不是可处理的图片内容。 |  -  |
+| **413** | 上传图片体积、拉取到的图片体积、源图片像素，或者输出图片像素超过限制。 |  -  |
+| **500** | 服务器处理失败，例如图片编码阶段发生错误。 |  -  |
+| **502** | 图片下载失败，或者图片链接返回的不是可识别的图片内容。 |  -  |
+| **503** | 当前图片处理任务过多，或者暂时无法获取图片。 |  -  |
+| **504** | 获取图片超时。 |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## postImageFrombase64
 
 > PostImageFrombase64200Response postImageFrombase64(postImageFrombase64Request)
@@ -676,6 +875,96 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## postImageOcr
+
+> PostImageOcr200Response postImageOcr(file, url, imageBase64, imageName, needLocation, returnMarkdown, enableCls)
+
+通用 OCR 文字识别
+
+无论您是需要实现票据的自动化录入，还是在网页前端对图片上的文字进行坐标框选，这个高精度的 OCR 接口都能为您提供强大的基础能力。  ## 功能概述 &gt; [!IMPORTANT] &gt; 如果您只关心图片上写了什么（例如截图取字或内容安全审核），强烈建议将 &#x60;need_location&#x60; 设置为 &#x60;false&#x60;。这会大幅精简返回的 JSON 数据体积，提升网络传输与系统解析效率。  除了常规的图片转文字，这个接口还针对实际开发场景做了一些实用设计： - **前端文字高亮与结构化分析**：默认返回每一段文字的矩形坐标和四个顶点坐标。这非常适合使用 Canvas 在原图上画框高亮，或者在后端根据相对位置提取票据中的键值对信息。 - **复杂拍摄环境下的抗畸变**：针对手机拍摄导致的旋转或倾斜，可以开启 &#x60;enable_cls&#x3D;true&#x60;。服务端在识别前会自动进行方向预校正，显著提升识别准确率。 - **灵活的输入与请求要求**：接口支持 &#x60;file&#x60;、&#x60;url&#x60; 或 &#x60;image_base64&#x60; 三种方式输入。请确保请求格式为 &#x60;multipart/form-data&#x60;，且图片链接在公网可直接访问。
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ImageApi,
+} from 'uapi-browser-sdk-browser';
+import type { PostImageOcrRequest } from 'uapi-browser-sdk-browser';
+
+async function example() {
+  console.log("🚀 Testing uapi-browser-sdk-browser SDK...");
+  const api = new ImageApi();
+
+  const body = {
+    // Blob | 待识别的图片文件。支持 JPG、JPEG、PNG、BMP、GIF、WebP 等常见格式，最大不超过 10MB。请勿与 url 或 image_base64 同时提交。 (optional)
+    file: BINARY_DATA_HERE,
+    // string | 公网可直接访问的图片地址。请勿与 file 或 image_base64 同时提交。 (optional)
+    url: url_example,
+    // string | 图片的 Base64 字符串。可以传完整 Data URI，也可以只传纯 Base64 内容。请勿与 file 或 url 同时提交。 (optional)
+    imageBase64: imageBase64_example,
+    // string | 自定义图片文件名。传链接或纯 Base64 时建议一起传，便于保留或推断扩展名。 (optional)
+    imageName: imageName_example,
+    // string | 是否返回文字坐标信息。请传 `true` 或 `false`，不传时默认是 `true`。 (optional)
+    needLocation: needLocation_example,
+    // string | 是否额外返回整理后的 Markdown 文本。请传 `true` 或 `false`，不传时默认是 `false`。 (optional)
+    returnMarkdown: returnMarkdown_example,
+    // string | 是否开启额外的文字方向校正。请传 `true` 或 `false`，不传时默认是 `false`。 (optional)
+    enableCls: enableCls_example,
+  } satisfies PostImageOcrRequest;
+
+  try {
+    const data = await api.postImageOcr(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **file** | `Blob` | 待识别的图片文件。支持 JPG、JPEG、PNG、BMP、GIF、WebP 等常见格式，最大不超过 10MB。请勿与 url 或 image_base64 同时提交。 | [Optional] [Defaults to `undefined`] |
+| **url** | `string` | 公网可直接访问的图片地址。请勿与 file 或 image_base64 同时提交。 | [Optional] [Defaults to `undefined`] |
+| **imageBase64** | `string` | 图片的 Base64 字符串。可以传完整 Data URI，也可以只传纯 Base64 内容。请勿与 file 或 url 同时提交。 | [Optional] [Defaults to `undefined`] |
+| **imageName** | `string` | 自定义图片文件名。传链接或纯 Base64 时建议一起传，便于保留或推断扩展名。 | [Optional] [Defaults to `undefined`] |
+| **needLocation** | `true`, `false` | 是否返回文字坐标信息。请传 &#x60;true&#x60; 或 &#x60;false&#x60;，不传时默认是 &#x60;true&#x60;。 | [Optional] [Defaults to `&#39;true&#39;`] [Enum: true, false] |
+| **returnMarkdown** | `true`, `false` | 是否额外返回整理后的 Markdown 文本。请传 &#x60;true&#x60; 或 &#x60;false&#x60;，不传时默认是 &#x60;false&#x60;。 | [Optional] [Defaults to `&#39;false&#39;`] [Enum: true, false] |
+| **enableCls** | `true`, `false` | 是否开启额外的文字方向校正。请传 &#x60;true&#x60; 或 &#x60;false&#x60;，不传时默认是 &#x60;false&#x60;。 | [Optional] [Defaults to `&#39;false&#39;`] [Enum: true, false] |
+
+### Return type
+
+[**PostImageOcr200Response**](PostImageOcr200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `multipart/form-data`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | 识别成功，返回统一的 OCR 结果对象。默认会带坐标信息；当 &#x60;need_location&#x3D;false&#x60; 时，坐标相关字段会省略。 |  -  |
+| **400** | 请求参数不正确，比如没有传图片来源、提交了多重图片来源，或者布尔参数和 Base64 格式不合法。 |  -  |
+| **413** | 图片大小超过当前限制。 |  -  |
+| **415** | 上传内容不是可识别的常见图片格式。 |  -  |
+| **502** | 识别处理失败，请稍后重试。 |  -  |
+| **503** | 文字识别服务暂时不可用，请稍后再试。 |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## postImageSpeechless
 
 > Blob postImageSpeechless(postImageSpeechlessRequest)

package/internal/docs/Markdown.md

@@ -0,0 +1,36 @@
+
+# Markdown
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`code` | string
+`message` | string
+
+## Example
+
+```typescript
+import type { Markdown } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "code": TEXT_TOO_LARGE,
+  "message": Markdown 内容不能超过 1MB,
+} satisfies Markdown
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as Markdown
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/MiscApi.md

@@ -242,11 +242,11 @@ No authorization required
 
 ## getMiscHolidayCalendar
 
-> GetMiscHolidayCalendar200Response getMiscHolidayCalendar(date, month, year, timezone, holidayType, includeNearby, nearbyLimit)
+> GetMiscHolidayCalendar200Response getMiscHolidayCalendar(date, month, year, timezone, holidayType, includeNearby, nearbyLimit, excludePast)
 
 查询节假日与万年历
 
-查询指定日期、月份或年份的万年历与节假日信息。  ## 功能概述 这个接口支持三种查询方式：按天（`date`）、按月（`month`）和按年（`year`）。调用时三者选一个传入即可。  如果你只关心某一类事件，可以通过 `holiday_type` 进行筛选，例如只看法定休假/调休、公历节日、农历节日或节气。  在 `date` 模式下，传 `include_nearby=true` 可以额外返回该日期前后最近的节日；返回数量由 `nearby_limit` 控制，默认 7，最大 30。
+查询指定日期、月份或年份的万年历与节假日信息。  ## 功能概述 这个接口支持三种查询方式：按天（`date`）、按月（`month`）和按年（`year`）。调用时三者选一个传入即可。  如果你只关心某一类事件，可以通过 `holiday_type` 进行筛选，例如只看法定休假/调休、公历节日、农历节日或节气。  在 `date` 模式下，传 `include_nearby=true` 可以额外返回该日期前后最近的节日；返回数量由 `nearby_limit` 控制，默认 7，最大 30。  如果你只想保留今天和之后的节日，可以再传 `exclude_past=true` 过滤已经过去的节日。
 
 ### Example
 
@@ -276,6 +276,8 @@ async function example() {
     includeNearby: true,
     // number | 返回最近节日数量限制，默认 7，最大 30。仅 date 模式 + include_nearby=true 生效。 (optional)
     nearbyLimit: 7,
+    // boolean | 传 true 时，会过滤今天之前已经过去的节日。默认 false。 (optional)
+    excludePast: true,
   } satisfies GetMiscHolidayCalendarRequest;
 
   try {
@@ -302,6 +304,7 @@ example().catch(console.error);
 | **holidayType** | `all`, `legal`, `legal_rest`, `legal_workday`, `solar`, `lunar`, `term` | 节日筛选类型，默认 all。 | [Optional] [Defaults to `'all'`] [Enum: all, legal, legal_rest, legal_workday, solar, lunar, term] |
 | **includeNearby** | `boolean` | 是否返回前后最近节日，仅 date 模式生效，默认 false。month/year 模式会忽略此参数。 | [Optional] [Defaults to `false`] |
 | **nearbyLimit** | `number` | 返回最近节日数量限制，默认 7，最大 30。仅 date 模式 + include_nearby=true 生效。 | [Optional] [Defaults to `7`] |
+| **excludePast** | `boolean` | 传 true 时，会过滤今天之前已经过去的节日。默认 false。 | [Optional] [Defaults to `false`] |
 
 ### Return type
 
@@ -328,11 +331,11 @@ No authorization required
 
 ## getMiscHotboard
 
-> GetMiscHotboard200Response getMiscHotboard(type, time, keyword, timeStart, timeEnd, limit, sources)
+> GetMiscHotboard200Response getMiscHotboard(type, time, keyword, timeStart, timeEnd, limit)
 
 查询热榜
 
-想快速跟上网络热点？这个接口让你一网打尽各大主流平台的实时热榜/热搜！  ## 功能概述 你只需要指定一个平台类型，就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。  ## 三种使用模式  ### 默认模式 只传 `type` 参数，返回该平台当前的实时热榜。  ### 时光机模式 传 `type` + `time` 参数，返回最接近指定时间的热榜快照。如果不可用或无数据，会返回空。  ### 搜索模式 传 `type` + `keyword` + `time_start` + `time_end` 参数，在指定时间范围内搜索包含关键词的热榜条目。可选传 `limit` 限制返回数量。  ### 数据源列表 传 `sources=true`，返回所有支持历史数据的平台列表。
+想快速跟上网络热点？这个接口让你一网打尽各大主流平台的实时热榜/热搜！  ## 功能概述 你只需要指定一个平台类型，就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。  ## 三种使用模式  ### 默认模式 只传 `type` 参数，返回该平台当前的实时热榜。  ### 时光机模式 传 `type` + `time` 参数，返回最接近指定时间的热榜快照。如果不可用或无数据，会返回空。  ### 搜索模式 传 `type` + `keyword` + `time_start` + `time_end` 参数，在指定时间范围内搜索包含关键词的热榜条目。可选传 `limit` 限制返回数量。
 
 ### Example
 
@@ -360,8 +363,6 @@ async function example() {
     timeEnd: 789,
     // number | 搜索模式下最大返回条数，默认 50，最大 200。 (optional)
     limit: 56,
-    // boolean | 设为 true 时列出所有可用的历史数据源，忽略其他参数。 (optional)
-    sources: true,
   } satisfies GetMiscHotboardRequest;
 
   try {
@@ -387,7 +388,6 @@ example().catch(console.error);
 | **timeStart** | `number` | 搜索模式必填：搜索起始时间戳（毫秒）。 | [Optional] [Defaults to `undefined`] |
 | **timeEnd** | `number` | 搜索模式必填：搜索结束时间戳（毫秒）。 | [Optional] [Defaults to `undefined`] |
 | **limit** | `number` | 搜索模式下最大返回条数，默认 50，最大 200。 | [Optional] [Defaults to `undefined`] |
-| **sources** | `boolean` | 设为 true 时列出所有可用的历史数据源，忽略其他参数。 | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -406,10 +406,10 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | 查询成功！返回指定平台的热榜列表数据。不同模式返回格式不同：默认模式和时光机模式返回 list 数组；搜索模式返回 results 数组；数据源列表模式返回 sources 数组。 |  -  |
+| **200** | 查询成功！返回指定平台的热榜列表数据。不同模式返回格式不同：默认模式和时光机模式返回 list 数组；搜索模式返回 results 数组。 |  -  |
 | **400** | 请求参数错误。你提供的 `type` 参数不是我们支持的平台类型，请检查拼写。 |  -  |
 | **500** | 获取热榜失败。服务器在处理数据时发生内部错误。 |  -  |
-| **502** | 上游服务错误。我们从目标平台（如微博）获取数据时失败，可能是对方接口暂时不可用或有反爬策略。 |  -  |
+| **502** | 暂时无法获取相关数据，请稍后重试。 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
@@ -834,11 +834,11 @@ No authorization required
 
 ## getMiscTrackingQuery
 
-> GetMiscTrackingQuery200Response getMiscTrackingQuery(trackingNumber, carrierCode, phone)
+> GetMiscTrackingQuery200Response getMiscTrackingQuery(trackingNumber, carrierCode, phone, full)
 
 查询快递物流信息
 
-买了东西想知道快递到哪儿了？这个接口帮你实时追踪物流状态。  ## 功能概述 提供一个快递单号，系统会自动识别快递公司并返回完整的物流轨迹信息。这个接口目前可以查询中通、圆通、韵达、申通、极兔、京东、EMS、德邦等主流快递公司的物流信息。  ## 使用须知 目前暂不支持顺丰快递单号的物流查询。  - **自动识别**：不知道是哪家快递？系统会根据单号规则自动识别快递公司（推荐使用） - **手动指定**：如果已知快递公司，可以传递 `carrier_code` 参数，查询速度会更快 - **手机尾号验证**：部分快递公司需要验证收件人手机尾号才能查询详细物流，如果返回 `暂无物流信息`，建议尝试传入 `phone` 参数 - **查询时效**：物流信息实时查询，响应时间通常在1-2秒内
+买了东西想知道快递到哪儿了？这个接口帮你实时追踪物流状态。  ## 功能概述 提供一个快递单号，系统会自动识别快递公司并返回完整的物流轨迹信息。这个接口目前可以查询中通、圆通、韵达、申通、极兔、顺丰、京东、EMS、德邦等主流快递公司的物流信息。  ## 使用须知 - **自动识别**：不知道是哪家快递？系统会根据单号规则自动识别快递公司（推荐使用） - **手动指定**：如果已知快递公司，可以传递 `carrier_code` 参数，查询速度会更快 - **手机尾号验证**：顺丰等部分快递公司需要验证收件人手机尾号才能查询详细物流，如果返回 `暂无物流信息`，建议尝试传入 `phone` 参数 - **查询时效**：物流信息实时查询，响应时间通常在1-2秒内
 
 ### Example
 
@@ -860,6 +860,8 @@ async function example() {
     carrierCode: carrierCode_example,
     // string | 收件人手机尾号，4位数字（可选）。部分快递公司需要验证手机尾号才能查询详细物流信息。 (optional)
     phone: phone_example,
+    // boolean | 使用这个参数可以获得完整的物流信息。但会消耗34积分/一次（不过缓存命中半价）。因为成本实在太贵了，否则非常非常亏说是 (optional)
+    full: true,
   } satisfies GetMiscTrackingQueryRequest;
 
   try {
@@ -882,6 +884,7 @@ example().catch(console.error);
 | **trackingNumber** | `string` | 快递单号，通常是一串10-20位的数字或字母数字组合。 | [Defaults to `undefined`] |
 | **carrierCode** | `string` | 快递公司编码（可选）。不填写时系统会自动识别，填写后可加快查询速度。 | [Optional] [Defaults to `undefined`] |
 | **phone** | `string` | 收件人手机尾号，4位数字（可选）。部分快递公司需要验证手机尾号才能查询详细物流信息。 | [Optional] [Defaults to `undefined`] |
+| **full** | `boolean` | 使用这个参数可以获得完整的物流信息。但会消耗34积分/一次（不过缓存命中半价）。因为成本实在太贵了，否则非常非常亏说是 | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 

package/internal/docs/NetworkApi.md

@@ -153,7 +153,7 @@ No authorization required
 |-------------|-------------|------------------|
 | **200** | 查询成功！返回该域名的ICP备案详情。 |  -  |
 | **400** | 请求参数无效。请检查 `domain` 参数是否提供且格式正确。 |  -  |
-| **404** | 未查询到备案信息。该域名可能没有在工信部备案，或者是我们查询的上游接口暂时没有收录。 |  -  |
+| **404** | 未查询到备案信息。该域名可能没有在工信部备案，或者当前暂无可用结果。 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
@@ -164,7 +164,7 @@ No authorization required
 
 查询 IP
 
-想知道一个IP地址或域名来自地球的哪个角落？这个接口可以帮你定位它。你可以使用默认数据源，也可以指定 `source=commercial` 参数来查询更详细的商业级IP归属信息。  ## 功能概述 提供一个公网IPv4、IPv6地址或域名，我们会查询并返回它的地理位置（国家、省份、城市）、经纬度、以及所属的运营商（ISP）和自治系统（ASN）信息。这在网络安全分析、访问来源统计等领域非常有用。  当使用 `source=commercial` 参数时，接口将调用高性能商业API，提供更精确的市、区、运营商、时区、海拔等信息。请注意，商业查询的响应时间可能会稍长。
+想知道一个IP地址或域名来自哪里？这个接口可以帮你定位它。默认返回标准结果；如果传 `source=commercial`，可以返回更完整的位置信息。  ## 功能概述 提供一个公网IPv4、IPv6地址或域名，我们会查询并返回它的地理位置（国家、省份、城市）、经纬度、以及所属的运营商（ISP）和自治系统（ASN）信息。这在网络安全分析、访问来源统计等领域非常有用。  当传 `source=commercial` 时，响应中会补充更完整的市、区、运营商、时区、海拔等信息，响应时间可能会稍长。
 
 ### Example
 
@@ -182,7 +182,7 @@ async function example() {
   const body = {
     // string | 你需要查询的公网IP地址或域名（支持IPv4和IPv6）。
     ip: cn.bing.com,
-    // 'commercial' | 查询的数据源。如果留空，将使用默认的数据库。如果设置为 `commercial`，将调用商业级API，返回更详细的地理位置信息，但响应时间可能会稍长。 (optional)
+    // 'commercial' | 查询结果类型。不传时返回标准结果；如果设置为 `commercial`，将返回更完整的地理位置信息，但响应时间可能会稍长。 (optional)
     source: source_example,
   } satisfies GetNetworkIpinfoRequest;
 
@@ -204,7 +204,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **ip** | `string` | 你需要查询的公网IP地址或域名（支持IPv4和IPv6）。 | [Defaults to `undefined`] |
-| **source** | `commercial` | 查询的数据源。如果留空，将使用默认的数据库。如果设置为 `commercial`，将调用商业级API，返回更详细的地理位置信息，但响应时间可能会稍长。 | [Optional] [Defaults to `undefined`] [Enum: commercial] |
+| **source** | `commercial` | 查询结果类型。不传时返回标准结果；如果设置为 `commercial`，将返回更完整的地理位置信息，但响应时间可能会稍长。 | [Optional] [Defaults to `undefined`] [Enum: commercial] |
 
 ### Return type
 
@@ -237,7 +237,7 @@ No authorization required
 
 查询我的 IP
 
-想知道你自己的出口公网IP是多少吗？这个接口就是你的“网络身份证”。你可以使用默认数据源，也可以指定 `source=commercial` 参数来查询更详细的商业级IP归属信息。  ## 功能概述 调用此接口，它会返回你（即发起请求的客户端）的公网IP地址，并附带与 `/network/ipinfo` 接口相同的地理位置和网络归属信息。非常适合用于在网页上向用户展示他们自己的IP和地理位置。  当使用 `source=commercial` 参数时，接口将调用高性能商业API，提供更精确的市、区、运营商、时区、海拔等信息。请注意，商业查询的响应时间可能会稍长。
+想知道你自己的出口公网IP是多少吗？这个接口就是你的“网络身份证”。默认返回标准结果；如果传 `source=commercial`，可以返回更完整的位置信息。  ## 功能概述 调用此接口，它会返回你（即发起请求的客户端）的公网IP地址，并附带与 `/network/ipinfo` 接口相同的地理位置和网络归属信息。非常适合用于在网页上向用户展示他们自己的IP和地理位置。  当传 `source=commercial` 时，响应中会补充更完整的市、区、运营商、时区、海拔等信息，响应时间可能会稍长。
 
 ### Example
 
@@ -253,7 +253,7 @@ async function example() {
   const api = new NetworkApi();
 
   const body = {
-    // 'commercial' | 查询的数据源。如果留空，将使用默认的数据库。如果设置为 `commercial`，将调用商业级API，返回更详细的地理位置信息，但响应时间可能会稍长。 (optional)
+    // 'commercial' | 查询结果类型。不传时返回标准结果；如果设置为 `commercial`，将返回更完整的地理位置信息，但响应时间可能会稍长。 (optional)
     source: source_example,
   } satisfies GetNetworkMyipRequest;
 
@@ -274,7 +274,7 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **source** | `commercial` | 查询的数据源。如果留空，将使用默认的数据库。如果设置为 `commercial`，将调用商业级API，返回更详细的地理位置信息，但响应时间可能会稍长。 | [Optional] [Defaults to `undefined`] [Enum: commercial] |
+| **source** | `commercial` | 查询结果类型。不传时返回标准结果；如果设置为 `commercial`，将返回更完整的地理位置信息，但响应时间可能会稍长。 | [Optional] [Defaults to `undefined`] [Enum: commercial] |
 
 ### Return type
 
@@ -710,7 +710,7 @@ No authorization required
 |-------------|-------------|------------------|
 | **200** | 查询成功！返回该域名在微信中的状态。 |  -  |
 | **400** | 请求参数无效。 |  -  |
-| **502** | 查询上游接口失败。 |  -  |
+| **502** | 暂时无法完成查询，请稍后重试。 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)