1. 令牌
梧柏API使用文档
WHBAI · 账号与令牌
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • 系统管理
    • 令牌
      • 获取令牌列表
        GET
      • 新增令牌
        POST
      • 修改令牌
        PUT
      • 搜索令牌
        GET
      • 批量修改令牌
        PUT
      • 删除令牌
        DELETE
      • 获取令牌使用情况
        GET
    • 账号
      • 获取账号信息
    • 图床
      • 上传图片
  • 数据模型
    • ApiEnvelope
    • Token
    • TokenCreate
    • TokenUpdate
    • TokenBatchUpdate
    • TokenUsage
    • UserSelf
    • ApiSuccessPageTokens
    • ApiSuccessToken
    • ApiSuccessTokenList
    • ApiSuccessString
    • ApiSuccessInt
    • ApiSuccessEmpty
    • ApiSuccessTokenUsage
    • ApiSuccessUser
    • NewApiError
  1. 令牌

批量修改令牌

PUT
/api/token/batch
批量更新多个令牌。ids 为整数数组;update_fields 列出要更新的字段名,仅这些字段会生效。

网站中的模型与调用示例#

批量修改令牌#

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "allow_ips": {
      "description": "【可选】白名单 按\\n号分割",
      "type": "string"
    },
    "expired_time": {
      "description": "【可选】过期时间",
      "type": "integer"
    },
    "group": {
      "description": "【可选】分组 多个逗号分隔,顺序优先",
      "type": "string"
    },
    "ids": {
      "description": "这里是要修改的token id,多个以逗号分隔",
      "properties": {
        "873,869": {
          "description": "某个id 或多个id,用逗号分隔",
          "type": "string"
        }
      },
      "required": [
        "873,869"
      ],
      "type": "object"
    },
    "mj_custom_proxy": {
      "description": "【可选】自定义图片代理地址 只有 mj_image_mode 为",
      "type": "string"
    },
    "mj_image_mode": {
      "description": "【可选】配置图片代理方式 暂时只有 origin 和 proxy 两种",
      "type": "string"
    },
    "model_limits": {
      "description": "【可选】模型限制列表 多个以逗号分隔",
      "type": "string"
    },
    "model_limits_enabled": {
      "description": "【可选】访问限制【可用模型限制设置】",
      "type": "boolean"
    },
    "remain_quota": {
      "description": "【可选】额度 50w为1刀",
      "type": "integer"
    },
    "unlimited_quota": {
      "description": "【可选】true 为无限额度,false 则填写 remain_quota有效",
      "type": "boolean"
    },
    "update_fields": {
      "description": "修改的",
      "properties": {
        "allow_ips": {
          "description": "【可选】白名单 按\\n号分割",
          "type": "string"
        },
        "expired_time": {
          "description": "【可选】过期时间",
          "type": "string"
        },
        "group": {
          "description": "【可选】分组",
          "type": "string"
        },
        "mj_custom_proxy": {
          "description": "【可选】自定义图片代理地址",
          "type": "string"
        },
        "mj_image_mode": {
          "description": "【可选】配置图片代理方式",
          "type": "string"
        },
        "model_limits": {
          "description": "【可选】模型限制列表",
          "type": "string"
        },
        "model_limits_enabled": {
          "description": "【可选】访问限制【可用模型限制设置】",
          "type": "string"
        },
        "remain_quota": {
          "description": "【可选】额度 50w为1刀",
          "type": "string"
        },
        "unlimited_quota": {
          "description": "【可选】true 为无限额度,false 则填写 remain_quota有效",
          "type": "string"
        }
      },
      "required": [
        "group",
        "expired_time",
        "remain_quota",
        "unlimited_quota",
        "model_limits",
        "allow_ips",
        "mj_image_mode",
        "mj_custom_proxy",
        "model_limits_enabled"
      ],
      "type": "object"
    }
  },
  "required": [
    "ids",
    "group",
    "expired_time",
    "remain_quota",
    "unlimited_quota",
    "model_limits",
    "model_limits_enabled",
    "allow_ips",
    "mj_image_mode",
    "mj_custom_proxy",
    "update_fields"
  ]
}

请求示例 · 示例 1#

"{\r\n    // 这里是要修改的token id,所以要先获取token id\r\n    \"ids\": [\r\n        873,\r\n        869\r\n    ],\r\n\r\n    // 【分组优先级选择】,可以多个逗号分隔\r\n    \"group\": \"default\",\r\n\r\n    // 【过期时间】,如果是【永不限制】,则填-1,也可以填写时间戳\r\n    \"expired_time\": 1776410923,\r\n\r\n    // 【额度】\r\n    \"remain_quota\": 0,\r\n\r\n    // 【额度】,如果为true 则为【无限额度】\r\n    \"unlimited_quota\": true,\r\n\r\n    // 【模型限制列表】多选,逗号分隔开来\r\n    \"model_limits\": \"gpt-4o,gpt-4o-2024-11-20\",\r\n\r\n    // 访问限制【可用模型限制设置】\r\n    \"model_limits_enabled\": true,\r\n\r\n    // 访问限制【白名单】\r\n    \"allow_ips\": \"192.168.1.1\",\r\n\r\n    // 此列对应【Midjourney 设置 配置图片代理方式】 \r\n    \"mj_image_mode\": \"origin\",\r\n\r\n    // 自定义图片代理地址 【目前只有:配置图片代理方式为 <(proxy) 图片代理地址(国外很慢,国内可以访问)>】\r\n    \"mj_custom_proxy\": \"\",\r\n    \r\n    // 需要批量修改的列【字段】,可以选择其中的一个或者全部\r\n    \"update_fields\": [\r\n        \"group\",\r\n        \"expired_time\",\r\n        \"remain_quota\",\r\n        \"unlimited_quota\",\r\n        \"model_limits\",\r\n        \"allow_ips\",\r\n        \"mj_image_mode\",\r\n        \"mj_custom_proxy\"\r\n    ]\r\n}"

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Header 参数

Body 参数application/json必填

示例
{
    // 这里是要修改的token id,所以要先获取token id
    "ids": [
        873,
        869
    ],

    // 【分组优先级选择】,可以多个逗号分隔
    "group": "default",

    // 【过期时间】,如果是【永不限制】,则填-1,也可以填写时间戳
    "expired_time": 1776410923,

    // 【额度】
    "remain_quota": 0,

    // 【额度】,如果为true 则为【无限额度】
    "unlimited_quota": true,

    // 【模型限制列表】多选,逗号分隔开来
    "model_limits": "gpt-4o,gpt-4o-2024-11-20",

    // 访问限制【可用模型限制设置】
    "model_limits_enabled": true,

    // 访问限制【白名单】
    "allow_ips": "192.168.1.1",

    // 此列对应【Midjourney 设置 配置图片代理方式】 
    "mj_image_mode": "origin",

    // 自定义图片代理地址 【目前只有:配置图片代理方式为 <(proxy) 图片代理地址(国外很慢,国内可以访问)>】
    "mj_custom_proxy": "",
    
    // 需要批量修改的列【字段】,可以选择其中的一个或者全部
    "update_fields": [
        "group",
        "expired_time",
        "remain_quota",
        "unlimited_quota",
        "model_limits",
        "allow_ips",
        "mj_image_mode",
        "mj_custom_proxy"
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT '/api/token/batch' \
--header 'New-Api-User: 1' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    // 这里是要修改的token id,所以要先获取token id
    "ids": [
        873,
        869
    ],

    // 【分组优先级选择】,可以多个逗号分隔
    "group": "default",

    // 【过期时间】,如果是【永不限制】,则填-1,也可以填写时间戳
    "expired_time": 1776410923,

    // 【额度】
    "remain_quota": 0,

    // 【额度】,如果为true 则为【无限额度】
    "unlimited_quota": true,

    // 【模型限制列表】多选,逗号分隔开来
    "model_limits": "gpt-4o,gpt-4o-2024-11-20",

    // 访问限制【可用模型限制设置】
    "model_limits_enabled": true,

    // 访问限制【白名单】
    "allow_ips": "192.168.1.1",

    // 此列对应【Midjourney 设置 配置图片代理方式】 
    "mj_image_mode": "origin",

    // 自定义图片代理地址 【目前只有:配置图片代理方式为 <(proxy) 图片代理地址(国外很慢,国内可以访问)>】
    "mj_custom_proxy": "",
    
    // 需要批量修改的列【字段】,可以选择其中的一个或者全部
    "update_fields": [
        "group",
        "expired_time",
        "remain_quota",
        "unlimited_quota",
        "model_limits",
        "allow_ips",
        "mj_image_mode",
        "mj_custom_proxy"
    ]
}'

返回响应

🟢200成功
application/json
成功;data 为更新条数
Bodyapplication/json

示例
{
    "success": true,
    "message": "string",
    "data": 0
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:21
上一页
搜索令牌
下一页
删除令牌
Built with