批量修改令牌

PUThttps://api.apizt.com/api/token/batch

一次更新当前账号下多枚令牌的选定配置字段，并返回成功修改条数。

ids 指定目标令牌，update_fields 指定本次要修改的配置项；新值与这两个数组放在同一层 JSON 中。

请求参数

Header 参数

Authorizationheaderstring必需

Bearer 后填写个人设置中的系统访问令牌，不使用模型 API Key。

示例: Bearer YOUR_SYSTEM_ACCESS_TOKEN

new-api-userheaderstring必需

当前用户 ID，须与系统访问令牌所属账号一致。

示例: 1

Content-Typeheaderstring必需

请求体使用 JSON。

示例: application/json

Body 参数 application/json

allow_ipsbodystring必需

【可选】白名单按\n号分割

expired_timebodyinteger必需

【可选】过期时间

groupbodystring必需

【可选】分组多个逗号分隔，顺序优先

idsbodyobject必需

这里是要修改的token id，多个以逗号分隔

mj_custom_proxybodystring必需

【可选】自定义图片代理地址只有 mj_image_mode 为

mj_image_modebodystring必需

【可选】配置图片代理方式暂时只有 origin 和 proxy 两种

model_limitsbodystring必需

【可选】模型限制列表多个以逗号分隔

model_limits_enabledbodyboolean必需

【可选】访问限制【可用模型限制设置】

remain_quotabodyinteger必需

【可选】额度 50w为1刀

unlimited_quotabodyboolean必需

【可选】true 为无限额度,false 则填写 remain_quota有效

update_fieldsbodyobject必需

修改的

返回响应

application/json

data integer

数据载荷（常为 Base64 或结构化对象）

message string

提示信息

success boolean

是否成功

调用时需携带系统访问令牌和当前账号 ID，填写方式见 Header 参数。

响应为结构示例，实际错误文本以返回的 message 或 error.message 为准。

当前控制台使用的 update_fields 配置项包括：group、group_ids、routing_priority、expired_time、remain_quota、unlimited_quota、model_limits、allow_ips、mj_image_mode、mj_custom_proxy。

update_fields 指定本次选择的配置项；分组预设、模型限制开关等配套字段按控制台规则一起提交。

请求体示例

{
  "ids": [
    873,
    869
  ],
  "group": "default",
  "expired_time": 1776410923,
  "remain_quota": 0,
  "unlimited_quota": true,
  "model_limits": "gpt-4o,gpt-4o-2024-11-20",
  "model_limits_enabled": true,
  "allow_ips": "192.168.1.1",
  "mj_image_mode": "origin",
  "mj_custom_proxy": "",
  "update_fields": [
    "group",
    "expired_time",
    "remain_quota",
    "unlimited_quota",
    "model_limits",
    "allow_ips",
    "mj_image_mode",
    "mj_custom_proxy"
  ]
}

请求示例代码

语言

curl -X PUT "https://api.apizt.com/api/token/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      873,
      869
    ],
    "group": "default",
    "expired_time": 1776410923,
    "remain_quota": 0,
    "unlimited_quota": true,
    "model_limits": "gpt-4o,gpt-4o-2024-11-20",
    "model_limits_enabled": true,
    "allow_ips": "192.168.1.1",
    "mj_image_mode": "origin",
    "mj_custom_proxy": "",
    "update_fields": [
      "group",
      "expired_time",
      "remain_quota",
      "unlimited_quota",
      "model_limits",
      "allow_ips",
      "mj_image_mode",
      "mj_custom_proxy"
    ]
  }'

import requests

url = "https://api.apizt.com/api/token/batch"
headers = {
}
response = requests.put(url, headers=headers, json={
  "ids": [
    873,
    869
  ],
  "group": "default",
  "expired_time": 1776410923,
  "remain_quota": 0,
  "unlimited_quota": True,
  "model_limits": "gpt-4o,gpt-4o-2024-11-20",
  "model_limits_enabled": True,
  "allow_ips": "192.168.1.1",
  "mj_image_mode": "origin",
  "mj_custom_proxy": "",
  "update_fields": [
    "group",
    "expired_time",
    "remain_quota",
    "unlimited_quota",
    "model_limits",
    "allow_ips",
    "mj_image_mode",
    "mj_custom_proxy"
  ]
})
print(response.status_code, response.text)

const response = await fetch("https://api.apizt.com/api/token/batch", {
  method: "PUT",
  headers: {
  },
  body: JSON.stringify({
  "ids": [
    873,
    869
  ],
  "group": "default",
  "expired_time": 1776410923,
  "remain_quota": 0,
  "unlimited_quota": true,
  "model_limits": "gpt-4o,gpt-4o-2024-11-20",
  "model_limits_enabled": true,
  "allow_ips": "192.168.1.1",
  "mj_image_mode": "origin",
  "mj_custom_proxy": "",
  "update_fields": [
    "group",
    "expired_time",
    "remain_quota",
    "unlimited_quota",
    "model_limits",
    "allow_ips",
    "mj_image_mode",
    "mj_custom_proxy"
  ]
})
});
const text = await response.text();
console.log(response.status, text);

Python 需安装 requests；JavaScript 示例使用 ES 模块（.mjs）运行。

响应示例

{
  "data": 0,
  "message": "string",
  "success": true
}

{
  "error": {
    "message": "Invalid request (request id: 20260805120000123456789AbCdEfGh)",
    "type": "new_api_error"
  }
}

{
  "error": {
    "message": "无效的令牌 (request id: 20260805120000123456789AbCdEfGh)",
    "type": "new_api_error"
  }
}