@cherryin/api-client 0.0.1

package/docs/TextTokenInputPricing.md

@@ -0,0 +1,27 @@
+# TextTokenInputPricing
+
+TextTokenInputPricing 输入Token价格配置  Input token price configuration
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | id 价格配置ID  Price configuration ID | [optional] [default to undefined]
+**regular** | [**Array<TokenTier>**](TokenTier.md) | regular 常规价格层级  Regular price tiers | [optional] [default to undefined]
+**cached** | [**Array<TokenTier>**](TokenTier.md) | cached 缓存Token价格层级  Cached token price tiers | [optional] [default to undefined]
+**cache_write** | [**Array<TokenTier>**](TokenTier.md) | cache_write 缓存写入价格层级  Cache write price tiers | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { TextTokenInputPricing } from '@cherryin/api-client';
+
+const instance: TextTokenInputPricing = {
+    id,
+    regular,
+    cached,
+    cache_write,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/TextTokenOutputPricing.md

@@ -0,0 +1,25 @@
+# TextTokenOutputPricing
+
+TextTokenOutputPricing 输出Token价格配置  Output token price configuration
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | id 价格配置ID  Price configuration ID | [optional] [default to undefined]
+**regular** | [**Array<TokenTier>**](TokenTier.md) | regular 常规价格层级  Regular price tiers | [optional] [default to undefined]
+**reasoning** | [**Array<TokenTier>**](TokenTier.md) | reasoning 推理Token价格层级（如o1模型）  Reasoning token price tiers (e.g., o1 models) | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { TextTokenOutputPricing } from '@cherryin/api-client';
+
+const instance: TextTokenOutputPricing = {
+    id,
+    regular,
+    reasoning,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/TextTokenPricing.md

@@ -0,0 +1,23 @@
+# TextTokenPricing
+
+TextTokenPricing Token计费规则  Text token pricing rules
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**input** | [**TextTokenInputPricing**](TextTokenInputPricing.md) | input 输入Token价格配置  Input token price configuration | [optional] [default to undefined]
+**output** | [**TextTokenOutputPricing**](TextTokenOutputPricing.md) | output 输出Token价格配置  Output token price configuration | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { TextTokenPricing } from '@cherryin/api-client';
+
+const instance: TextTokenPricing = {
+    input,
+    output,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/TokenTier.md

@@ -0,0 +1,25 @@
+# TokenTier
+
+TokenTier Token价格层级  Token price tier
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**min_tokens** | **string** | min_tokens 最小token数量  Minimum token count | [optional] [default to undefined]
+**max_tokens** | **string** | max_tokens 最大token数量（0表示无限）  Maximum token count (0 means unlimited) | [optional] [default to undefined]
+**price_per_million** | **string** | price_per_million 每百万token价格（使用字符串避免精度损失）  Price per million tokens (string to avoid precision loss) | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { TokenTier } from '@cherryin/api-client';
+
+const instance: TokenTier = {
+    min_tokens,
+    max_tokens,
+    price_per_million,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UserAPIKey.md

@@ -0,0 +1,47 @@
+# UserAPIKey
+
+UserAPIKey 代表用户的 API 密钥  UserAPIKey represents a user\'s API key
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | id UserAPIKey 的唯一标识符  Unique identifier for the UserAPIKey | [optional] [default to undefined]
+**created_at** | **string** | created_at 创建时间戳（Unix 时间戳）  Creation timestamp (Unix timestamp) | [optional] [default to undefined]
+**updated_at** | **string** | updated_at 更新时间戳（Unix 时间戳）  Last update timestamp (Unix timestamp) | [optional] [default to undefined]
+**deleted_at** | **string** | deleted_at 软删除时间戳，0 表示未删除  Soft deletion timestamp, 0 means not deleted | [optional] [default to undefined]
+**uid** | **string** | uid 用户 ID  User ID | [optional] [default to undefined]
+**name** | **string** | name API Key 的唯一名称标识  Unique name identifier for the API key | [optional] [default to undefined]
+**key_group** | **string** | key_group API Key 分组  API Key group | [optional] [default to undefined]
+**display_name** | **string** | display_name API Key 的显示名称  Display name for the API key | [optional] [default to undefined]
+**quota_balance_total** | **string** | quota_balance_total 总配额余额，使用 DECIMAL(24,12) 精度存储  Total quota balance, stored with DECIMAL(24,12) precision  字符串格式，例如：\"100.50\" 表示 $100.50 或 ¥100.50  String format, e.g., \"100.50\" represents $100.50 or ¥100.50 | [optional] [default to undefined]
+**quota_balance_used** | **string** | quota_balance_used 已使用配额余额，使用 DECIMAL(24,12) 精度存储  Used quota balance, stored with DECIMAL(24,12) precision  字符串格式，例如：\"25.75\" 表示已使用 $25.75 或 ¥25.75  String format, e.g., \"25.75\" represents $25.75 or ¥25.75 used | [optional] [default to undefined]
+**balance_code** | **string** | balance_code 余额货币代码  Balance currency code  USD: 美元 (US Dollar)  CNY: 人民币 (Chinese Yuan) | [optional] [default to undefined]
+**quota_mode** | **number** | quota_mode 配额模式  Quota mode  1: 有限配额 (Limited)  2: 无限配额 (Unlimited) | [optional] [default to undefined]
+**key_status** | **string** | key_status API Key 状态  API Key status  1: 启用 (Enabled)  2: 禁用 (Disabled) | [optional] [default to undefined]
+**expires_at** | **string** | expires_at 过期时间戳，0 表示永不过期  Expiration timestamp, 0 means never expires | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UserAPIKey } from '@cherryin/api-client';
+
+const instance: UserAPIKey = {
+    id,
+    created_at,
+    updated_at,
+    deleted_at,
+    uid,
+    name,
+    key_group,
+    display_name,
+    quota_balance_total,
+    quota_balance_used,
+    balance_code,
+    quota_mode,
+    key_status,
+    expires_at,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UserAPIKeyCreateRequest.md

@@ -0,0 +1,37 @@
+# UserAPIKeyCreateRequest
+
+UserAPIKeyCreateRequest 创建 UserAPIKey 的请求  Request message for creating a new UserAPIKey
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**uid** | **string** | uid 用户 ID（管理员可以指定，普通用户自动使用当前用户）  User ID (admin can specify, normal user uses current user automatically) | [optional] [default to undefined]
+**name** | **string** | name API Key 的唯一名称标识  Unique name identifier for the API key | [optional] [default to undefined]
+**key_group** | **string** | key_group API Key 分组（可选）  API Key group (optional) | [optional] [default to undefined]
+**display_name** | **string** | display_name API Key 的显示名称  Display name for the API key | [optional] [default to undefined]
+**quota_balance_total** | **string** | quota_balance_total 总配额余额  Total quota balance  字符串格式，使用 DECIMAL(24,12) 精度，例如：\"100.50\"  String format with DECIMAL(24,12) precision, e.g., \"100.50\" | [optional] [default to undefined]
+**balance_code** | **string** | balance_code 余额货币代码（仅管理员可指定，默认从 user_balances 读取）  Balance currency code (admin only, defaults to reading from user_balances)  USD: 美元 (US Dollar)  CNY: 人民币 (Chinese Yuan) | [optional] [default to undefined]
+**quota_mode** | **number** | quota_mode 配额模式  Quota mode  1: 有限配额 (Limited)  2: 无限配额 (Unlimited) | [optional] [default to undefined]
+**key_status** | **string** | key_status API Key 状态  API Key status  1: 启用 (Enabled)  2: 禁用 (Disabled) | [optional] [default to undefined]
+**expires_at** | **string** | expires_at 过期时间戳，0 表示永不过期  Expiration timestamp, 0 means never expires | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UserAPIKeyCreateRequest } from '@cherryin/api-client';
+
+const instance: UserAPIKeyCreateRequest = {
+    uid,
+    name,
+    key_group,
+    display_name,
+    quota_balance_total,
+    balance_code,
+    quota_mode,
+    key_status,
+    expires_at,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UserAPIKeyCreateResponse.md

@@ -0,0 +1,25 @@
+# UserAPIKeyCreateResponse
+
+UserAPIKeyCreateResponse 创建 UserAPIKey 的响应  Response message for UserAPIKey creation
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**code** | **string** | code 响应状态码，0 表示成功  Response code, 0 indicates success | [optional] [default to undefined]
+**message** | **string** | message 响应消息  Response message | [optional] [default to undefined]
+**data** | [**UserAPIKey**](UserAPIKey.md) | data 创建成功后返回的 UserAPIKey 信息  UserAPIKey information returned after successful creation | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UserAPIKeyCreateResponse } from '@cherryin/api-client';
+
+const instance: UserAPIKeyCreateResponse = {
+    code,
+    message,
+    data,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UserAPIKeyDeleteRequest.md

@@ -0,0 +1,21 @@
+# UserAPIKeyDeleteRequest
+
+UserAPIKeyDeleteRequest 删除 UserAPIKey 的请求  Request message for deleting a UserAPIKey
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | id 要删除的 UserAPIKey 的唯一标识符  Unique identifier of the UserAPIKey to delete  @gotags: form:\"id\" binding:\"required\" | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UserAPIKeyDeleteRequest } from '@cherryin/api-client';
+
+const instance: UserAPIKeyDeleteRequest = {
+    id,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UserAPIKeyDeleteResponse.md

@@ -0,0 +1,23 @@
+# UserAPIKeyDeleteResponse
+
+UserAPIKeyDeleteResponse 删除 UserAPIKey 的响应  Response message for UserAPIKey deletion
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**code** | **string** | code 响应状态码，0 表示成功  Response code, 0 indicates success | [optional] [default to undefined]
+**message** | **string** | message 响应消息  Response message | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UserAPIKeyDeleteResponse } from '@cherryin/api-client';
+
+const instance: UserAPIKeyDeleteResponse = {
+    code,
+    message,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UserAPIKeyGetResponse.md

@@ -0,0 +1,25 @@
+# UserAPIKeyGetResponse
+
+UserAPIKeyGetResponse 获取单个 UserAPIKey 的响应  Response message for UserAPIKey retrieval
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**code** | **string** | code 响应状态码，0 表示成功  Response code, 0 indicates success | [optional] [default to undefined]
+**message** | **string** | message 响应消息  Response message | [optional] [default to undefined]
+**data** | [**UserAPIKey**](UserAPIKey.md) | data UserAPIKey 信息  UserAPIKey information | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UserAPIKeyGetResponse } from '@cherryin/api-client';
+
+const instance: UserAPIKeyGetResponse = {
+    code,
+    message,
+    data,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UserAPIKeyListResponse.md

@@ -0,0 +1,27 @@
+# UserAPIKeyListResponse
+
+UserAPIKeyListResponse 分页查询 UserAPIKey 列表的响应  Response message for UserAPIKey listing
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**code** | **string** | code 响应状态码，0 表示成功  Response code, 0 indicates success | [optional] [default to undefined]
+**message** | **string** | message 响应消息  Response message | [optional] [default to undefined]
+**list** | [**Array<UserAPIKey>**](UserAPIKey.md) | list UserAPIKey 列表  List of UserAPIKeys | [optional] [default to undefined]
+**total** | **string** | total 符合条件的 UserAPIKey 总数  Total number of UserAPIKeys matching the filter criteria | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UserAPIKeyListResponse } from '@cherryin/api-client';
+
+const instance: UserAPIKeyListResponse = {
+    code,
+    message,
+    list,
+    total,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UserAPIKeyServiceApi.md

@@ -0,0 +1,290 @@
+# UserAPIKeyServiceApi
+
+All URIs are relative to *http://localhost*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**userAPIKeyServiceUserAPIKeyCreate**](#userapikeyserviceuserapikeycreate) | **POST** /api/v1/user/api-key/create | |
+|[**userAPIKeyServiceUserAPIKeyDelete**](#userapikeyserviceuserapikeydelete) | **POST** /api/v1/user/api-key/delete | |
+|[**userAPIKeyServiceUserAPIKeyGet**](#userapikeyserviceuserapikeyget) | **GET** /api/v1/user/api-key/get | |
+|[**userAPIKeyServiceUserAPIKeyList**](#userapikeyserviceuserapikeylist) | **GET** /api/v1/user/api-key/list | |
+|[**userAPIKeyServiceUserAPIKeyUpdate**](#userapikeyserviceuserapikeyupdate) | **POST** /api/v1/user/api-key/update | |
+
+# **userAPIKeyServiceUserAPIKeyCreate**
+> UserAPIKeyCreateResponse userAPIKeyServiceUserAPIKeyCreate(userAPIKeyCreateRequest)
+
+UserAPIKeyCreate 创建新的 UserAPIKey  Create a new UserAPIKey   请求路径: POST /api/user/api-key/create  Request path: POST /api/user/api-key/create   权限要求: 需要用户认证  Permission: Requires user authentication
+
+### Example
+
+```typescript
+import {
+    UserAPIKeyServiceApi,
+    Configuration,
+    UserAPIKeyCreateRequest
+} from '@cherryin/api-client';
+
+const configuration = new Configuration();
+const apiInstance = new UserAPIKeyServiceApi(configuration);
+
+let userAPIKeyCreateRequest: UserAPIKeyCreateRequest; //
+
+const { status, data } = await apiInstance.userAPIKeyServiceUserAPIKeyCreate(
+    userAPIKeyCreateRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **userAPIKeyCreateRequest** | **UserAPIKeyCreateRequest**|  | |
+
+
+### Return type
+
+**UserAPIKeyCreateResponse**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | OK |  -  |
+|**0** | Default error response |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **userAPIKeyServiceUserAPIKeyDelete**
+> UserAPIKeyDeleteResponse userAPIKeyServiceUserAPIKeyDelete(userAPIKeyDeleteRequest)
+
+UserAPIKeyDelete 删除 UserAPIKey（软删除）  Delete a UserAPIKey (soft delete)   请求路径: POST /api/user/api-key/delete  Request path: POST /api/user/api-key/delete   权限要求: 需要用户认证  Permission: Requires user authentication
+
+### Example
+
+```typescript
+import {
+    UserAPIKeyServiceApi,
+    Configuration,
+    UserAPIKeyDeleteRequest
+} from '@cherryin/api-client';
+
+const configuration = new Configuration();
+const apiInstance = new UserAPIKeyServiceApi(configuration);
+
+let userAPIKeyDeleteRequest: UserAPIKeyDeleteRequest; //
+
+const { status, data } = await apiInstance.userAPIKeyServiceUserAPIKeyDelete(
+    userAPIKeyDeleteRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **userAPIKeyDeleteRequest** | **UserAPIKeyDeleteRequest**|  | |
+
+
+### Return type
+
+**UserAPIKeyDeleteResponse**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | OK |  -  |
+|**0** | Default error response |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **userAPIKeyServiceUserAPIKeyGet**
+> UserAPIKeyGetResponse userAPIKeyServiceUserAPIKeyGet()
+
+UserAPIKeyGet 根据 ID 或名称获取单个 UserAPIKey  Retrieve a single UserAPIKey by ID or name   请求路径: GET /api/user/api-key/get?id={id} 或 GET /api/user/api-key/get?name={name}  Request path: GET /api/user/api-key/get?id={id} or GET /api/user/api-key/get?name={name}   权限要求: 需要用户认证  Permission: Requires user authentication
+
+### Example
+
+```typescript
+import {
+    UserAPIKeyServiceApi,
+    Configuration
+} from '@cherryin/api-client';
+
+const configuration = new Configuration();
+const apiInstance = new UserAPIKeyServiceApi(configuration);
+
+let id: string; //id 要获取的 UserAPIKey 的唯一标识符  Unique identifier of the UserAPIKey to retrieve  @gotags: form:\"id\" (optional) (default to undefined)
+let name: string; //name 要获取的 UserAPIKey 的名称  Name of the UserAPIKey to retrieve  如果同时提供 id 和 name，以 id 为准  If both id and name are provided, id takes precedence  @gotags: form:\"name\" (optional) (default to undefined)
+
+const { status, data } = await apiInstance.userAPIKeyServiceUserAPIKeyGet(
+    id,
+    name
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **id** | [**string**] | id 要获取的 UserAPIKey 的唯一标识符  Unique identifier of the UserAPIKey to retrieve  @gotags: form:\"id\" | (optional) defaults to undefined|
+| **name** | [**string**] | name 要获取的 UserAPIKey 的名称  Name of the UserAPIKey to retrieve  如果同时提供 id 和 name，以 id 为准  If both id and name are provided, id takes precedence  @gotags: form:\"name\" | (optional) defaults to undefined|
+
+
+### Return type
+
+**UserAPIKeyGetResponse**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | OK |  -  |
+|**0** | Default error response |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **userAPIKeyServiceUserAPIKeyList**
+> UserAPIKeyListResponse userAPIKeyServiceUserAPIKeyList()
+
+UserAPIKeyList 分页查询 UserAPIKey 列表，支持按状态和分组过滤  List UserAPIKeys with pagination, supports filtering by status and key group   请求路径: GET /api/user/api-key/list?page={page}&page_size={page_size}&key_status={status}&key_group={group}  Request path: GET /api/user/api-key/list?page={page}&page_size={page_size}&key_status={status}&key_group={group}   权限要求: 需要用户认证  Permission: Requires user authentication
+
+### Example
+
+```typescript
+import {
+    UserAPIKeyServiceApi,
+    Configuration
+} from '@cherryin/api-client';
+
+const configuration = new Configuration();
+const apiInstance = new UserAPIKeyServiceApi(configuration);
+
+let page: number; //page 页码，从 1 开始  Page number, starts from 1  默认值: 1  Default: 1  @gotags: form:\"page\" (optional) (default to undefined)
+let pageSize: number; //page_size 每页数量  Number of items per page  默认值: 20，最大值: 100  Default: 20, Maximum: 100  @gotags: form:\"page_size\" (optional) (default to undefined)
+let uid: string; //uid 按用户 ID 过滤（可选，管理员可用）  Filter by user ID (optional, admin only)  0: 返回所有用户的 API Key（仅管理员）  > 0: 仅返回指定用户的 API Key  0: return API keys from all users (admin only)  > 0: return API keys from specific user only  @gotags: form:\"uid\" (optional) (default to undefined)
+let keyStatus: string; //key_status 按状态过滤（可选）  Filter by status (optional)  0: 返回所有状态  1: 仅返回启用的 API Key  2: 仅返回禁用的 API Key  0: return all statuses  1: return enabled API keys only  2: return disabled API keys only  @gotags: form:\"key_status\" (optional) (default to undefined)
+let keyGroup: string; //key_group 按分组过滤（可选）  Filter by key group (optional)  @gotags: form:\"key_group\" (optional) (default to undefined)
+
+const { status, data } = await apiInstance.userAPIKeyServiceUserAPIKeyList(
+    page,
+    pageSize,
+    uid,
+    keyStatus,
+    keyGroup
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **page** | [**number**] | page 页码，从 1 开始  Page number, starts from 1  默认值: 1  Default: 1  @gotags: form:\"page\" | (optional) defaults to undefined|
+| **pageSize** | [**number**] | page_size 每页数量  Number of items per page  默认值: 20，最大值: 100  Default: 20, Maximum: 100  @gotags: form:\"page_size\" | (optional) defaults to undefined|
+| **uid** | [**string**] | uid 按用户 ID 过滤（可选，管理员可用）  Filter by user ID (optional, admin only)  0: 返回所有用户的 API Key（仅管理员）  > 0: 仅返回指定用户的 API Key  0: return API keys from all users (admin only)  > 0: return API keys from specific user only  @gotags: form:\"uid\" | (optional) defaults to undefined|
+| **keyStatus** | [**string**] | key_status 按状态过滤（可选）  Filter by status (optional)  0: 返回所有状态  1: 仅返回启用的 API Key  2: 仅返回禁用的 API Key  0: return all statuses  1: return enabled API keys only  2: return disabled API keys only  @gotags: form:\"key_status\" | (optional) defaults to undefined|
+| **keyGroup** | [**string**] | key_group 按分组过滤（可选）  Filter by key group (optional)  @gotags: form:\"key_group\" | (optional) defaults to undefined|
+
+
+### Return type
+
+**UserAPIKeyListResponse**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | OK |  -  |
+|**0** | Default error response |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **userAPIKeyServiceUserAPIKeyUpdate**
+> UserAPIKeyUpdateResponse userAPIKeyServiceUserAPIKeyUpdate(userAPIKeyUpdateRequest)
+
+UserAPIKeyUpdate 更新现有的 UserAPIKey  Update an existing UserAPIKey   请求路径: POST /api/user/api-key/update  Request path: POST /api/user/api-key/update   权限要求: 需要用户认证  Permission: Requires user authentication
+
+### Example
+
+```typescript
+import {
+    UserAPIKeyServiceApi,
+    Configuration,
+    UserAPIKeyUpdateRequest
+} from '@cherryin/api-client';
+
+const configuration = new Configuration();
+const apiInstance = new UserAPIKeyServiceApi(configuration);
+
+let userAPIKeyUpdateRequest: UserAPIKeyUpdateRequest; //
+
+const { status, data } = await apiInstance.userAPIKeyServiceUserAPIKeyUpdate(
+    userAPIKeyUpdateRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **userAPIKeyUpdateRequest** | **UserAPIKeyUpdateRequest**|  | |
+
+
+### Return type
+
+**UserAPIKeyUpdateResponse**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | OK |  -  |
+|**0** | Default error response |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+

package/docs/UserAPIKeyUpdateRequest.md

@@ -0,0 +1,33 @@
+# UserAPIKeyUpdateRequest
+
+UserAPIKeyUpdateRequest 更新 UserAPIKey 的请求  Request message for updating an existing UserAPIKey
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | id UserAPIKey 的唯一标识符  Unique identifier of the UserAPIKey to update | [optional] [default to undefined]
+**display_name** | **string** | display_name API Key 的显示名称  Display name for the API key | [optional] [default to undefined]
+**quota_balance_total** | **string** | quota_balance_total 总配额余额  Total quota balance  字符串格式，使用 DECIMAL(24,12) 精度，例如：\"100.50\"  String format with DECIMAL(24,12) precision, e.g., \"100.50\" | [optional] [default to undefined]
+**balance_code** | **string** | balance_code 余额货币代码（仅管理员可修改）  Balance currency code (admin only)  USD: 美元 (US Dollar)  CNY: 人民币 (Chinese Yuan) | [optional] [default to undefined]
+**quota_mode** | **number** | quota_mode 配额模式  Quota mode  1: 有限配额 (Limited)  2: 无限配额 (Unlimited) | [optional] [default to undefined]
+**key_status** | **string** | key_status API Key 状态  API Key status  1: 启用 (Enabled)  2: 禁用 (Disabled) | [optional] [default to undefined]
+**expires_at** | **string** | expires_at 过期时间戳，0 表示永不过期  Expiration timestamp, 0 means never expires | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UserAPIKeyUpdateRequest } from '@cherryin/api-client';
+
+const instance: UserAPIKeyUpdateRequest = {
+    id,
+    display_name,
+    quota_balance_total,
+    balance_code,
+    quota_mode,
+    key_status,
+    expires_at,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UserAPIKeyUpdateResponse.md

@@ -0,0 +1,25 @@
+# UserAPIKeyUpdateResponse
+
+UserAPIKeyUpdateResponse 更新 UserAPIKey 的响应  Response message for UserAPIKey update
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**code** | **string** | code 响应状态码，0 表示成功  Response code, 0 indicates success | [optional] [default to undefined]
+**message** | **string** | message 响应消息  Response message | [optional] [default to undefined]
+**data** | [**UserAPIKey**](UserAPIKey.md) | data 更新后的 UserAPIKey 信息  Updated UserAPIKey information | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UserAPIKeyUpdateResponse } from '@cherryin/api-client';
+
+const instance: UserAPIKeyUpdateResponse = {
+    code,
+    message,
+    data,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)