模型服务开放API文档

API列表

GET 分页查询密钥资源列表

GET /xmodel/model/v1/statistics/resourceOptions/{next}/{size}

请求参数 - GET 分页查询密钥资源列表

名称	位置	类型	必选	说明
next	path	integer	是	当前页码，从 1 开始
size	path	integer	是	每页条数

{
  "code": "200",
  "res": {
    "current": 1,
    "elements": [
      {
        "allowedModels": [
          "deepseek-v4-flash"，
          "qwen3.6-plus"
        ],
        "apiKeyName": "测试环境key",
        "createTime": "2026-06-16 10:23:40",
        "dailyBudget": 0.0,
        "dailySpend": 0,
        "ipWhitelist": [
            "192.168.1.1",
            "192.168.1.10/24",
            "192.168.1.10-192.168.1.100"
        ],
        "monthlyBudget": 0.0,
        "monthlySpend": 0.36,
        "resourceId": "8c457db75e6649k2ba068816a0a69487",
        "status": "ENABLE"
      },
      {
        "allowedModels": [
          "*"
        ],
        "apiKeyName": "生产环境key",
        "createTime": "2026-06-01 22:56:39",
        "dailyBudget": 30.0,
        "dailySpend": 0,
        "ipWhitelist": [],
        "monthlyBudget": 200.0,
        "monthlySpend": 0,
        "resourceId": "20f4dedede75405acca11a0cfffc1408",
        "status": "ENABLE"
      }
    ],
    "page": 1,
    "size": 10,
    "total": 2
  },
  "status": true
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构 - GET 分页查询密钥资源列表

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回 code
» msg	string	false	none	提示信息
» res	object	true	none	分页结果
»» current	integer	true	none	当前页码
»» elements	[object]	true	none	密钥资源列表
»»» allowedModels	[string]	false	none	允许调用的模型列表， `*` 表示全部模型
»»» apiKeyName	string	false	none	API Key名称
»»» createTime	string	false	none	创建时间
»»» dailyBudget	number	false	none	日预算,0 表示不限制
»»» dailySpend	number	false	none	当日消费金额
»»» ipWhitelist	[string]	false	none	IP 白名单
»»» monthlyBudget	number	false	none	月预算,0 表示不限制
»»» monthlySpend	number	false	none	当月消费金额
»»» resourceId	string	false	none	模型平台资源ID，可作为统计和账单筛选条件
»»» status	string	false	none	资源状态
»» page	integer	true	none	当前页码
»» size	integer	true	none	每页条数
»» total	integer	true	none	总记录数

POST 查询调用统计概览

POST /xmodel/model/v1/statistics/overview

{
  "timeRange": "LAST_1_DAY",
  "startTime": "2026-05-09 17:49:02",
  "endTime": "2026-05-10 17:49:02",
  "resourceId": "model-resource-001"
}

请求参数 - POST 查询调用统计概览

名称	位置	类型	必选	说明
timeRange	body	string	否	快捷时间范围，可选 `LAST_1_HOUR`、 `LAST_1_DAY`、 `LAST_14_DAYS`、 `LAST_30_DAYS`
startTime	body	string	否	自定义开始时间，格式 `yyyy-MM-dd HH:mm:ss`
endTime	body	string	否	自定义结束时间，格式 `yyyy-MM-dd HH:mm:ss`
resourceId	body	string	否	模型平台资源ID

{
  "status": true,
  "code": "200",
  "res": {
    "totalRequests": 120,
    "totalTokens": 345678,
    "rows": [
      {
        "modelId": "deepseek-r1",
        "modelName": "DeepSeek R1",
        "modelType": "TEXT",
        "requestCount": 80,
        "totalTokens": 230000,
        "usageUnit": "Tokens"
      }
    ]
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构 - POST 查询调用统计概览

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态，true 成功 false 失败
» code	string	true	none	返回 code，200 成功
» msg	string	false	none	提示信息
» res	object	true	none	返回参数
»» totalRequests	integer	true	none	当前筛选周期内总请求数
»» totalTokens	integer	true	none	当前筛选周期内总 Token 数
»» rows	[object]	true	none	按模型聚合的统计行
»»» modelId	string	false	none	模型 ID
»»» modelName	string	false	none	模型名称
»»» modelType	string	false	none	模型类型
»»» requestCount	integer	false	none	请求数量
»»» totalTokens	integer	false	none	总 Token 数
»»» usageUnit	string	false	none	用量单位，文本模型通常为 Tokens

POST 分页查询调用明细

POST /xmodel/model/v1/statistics/detail/{next}/{size}

{
  "timeRange": "LAST_1_DAY",
  "startTime": "2026-06-01 00:00:00",
  "endTime": "2026-06-11 23:59:59",
  "resourceId": "model-resource-001",
  "traceId": "trace-202606110001"
}

请求参数 - POST 分页查询调用明细

名称	位置	类型	必选	说明
next	path	integer	是	当前页码，从 1 开始
size	path	integer	是	每页条数
timeRange	body	string	否	快捷时间范围，可选 `LAST_1_HOUR`、 `LAST_1_DAY`、 `LAST_14_DAYS`、 `LAST_30_DAYS`
startTime	body	string	否	自定义开始时间，格式 `yyyy-MM-dd HH:mm:ss`
endTime	body	string	否	自定义结束时间，格式 `yyyy-MM-dd HH:mm:ss`
resourceId	body	string	否	模型平台资源ID
modelType	body	string	否	模型类型
traceId	body	string	否	请求链路追踪 ID

{
  "status": true,
  "code": "200",
  "res": {
    "total": 1,
    "size": 20,
    "current": 1,
    "elements": [
      {
        "resourceId": "model-resource-001",
        "apiKeyName": "生产环境 Key",
        "modelId": "deepseek-r1",
        "modelName": "DeepSeek R1",
        "modelType": "TEXT",
        "statusCode": 200,
        "promptTokens": 120,
        "completionTokens": 300,
        "cachedTokens": 0,
        "totalTokens": 420,
        "usageUnit": "Tokens",
        "totalLatencyMs": 1380,
        "callTime": "2026-06-11 10:30:00"
      }
    ]
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构 - POST 分页查询调用明细

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回 code
» msg	string	false	none	提示信息
» res	object	true	none	分页结果
»» total	integer	true	none	总记录数
»» size	integer	true	none	每页条数
»» current	integer	true	none	当前页码
»» elements	[object]	true	none	调用明细列表
»»» resourceId	string	false	none	模型平台资源ID
»»» apiKeyName	string	false	none	API Key名称
»»» modelId	string	false	none	模型ID
»»» modelName	string	false	none	模型名称
»»» modelType	string	false	none	模型类型
»»» statusCode	integer	false	none	router 返回给调用方的 HTTP 状态码
»»» promptTokens	integer	false	none	输入 Token 数
»»» completionTokens	integer	false	none	输出 Token 数
»»» cachedTokens	integer	false	none	缓存 Token 数
»»» totalTokens	integer	false	none	总 Token 数
»»» usageUnit	string	false	none	用量单位
»»» totalLatencyMs	integer	false	none	总耗时，单位毫秒
»»» callTime	string	false	none	调用时间

POST 分页查询扣费记录列表

POST /xmodel/model/v1/bills/subscribeBillPageList/{next}/{size}

{
  "resourceId": "model-resource-001",
  "timeRange": "LAST_30_DAYS"
}

请求参数 - POST 分页查询扣费记录列表

名称	位置	类型	必选	说明
next	path	integer	是	当前页码，从 1 开始
size	path	integer	是	每页条数
resourceId	body	string	否	模型平台资源ID，用于筛选单个 API Key 资源账单
timeRange	body	string	否	快捷时间范围，可选 `LAST_1_HOUR`、 `LAST_1_DAY`、 `LAST_14_DAYS`、 `LAST_30_DAYS`
startTime	body	string	否	自定义开始时间，格式 `yyyy-MM-dd HH:mm:ss`
endTime	body	string	否	自定义结束时间，格式 `yyyy-MM-dd HH:mm:ss`

{
  "status": true,
  "code": "200",
  "res": {
    "pageInfo": {
      "total": 1,
      "size": 20,
      "current": 1,
      "elements": [
        {
          "resourceId": "4dec9a4c9b5e42228c17ed3cea737218",
          "apiKeyName": "生产环境 Key",
          "productRuleName": "模型服务后付费",
          "billRule": "每小时按模型消耗计费",
          "createTime": "2026-06-11 01:00:00",
          "billRecordCode": "pbr-d4c515b7e4d633e7b26e4f0774804f38",
          "startTime": "2026-06-10 00:00:00",
          "endTime": "2026-06-10 23:59:59",
          "state": "fee_success",
          "deductionAmount": 12.34
        }
      ]
    },
    "totalBillAmount": 12.34
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构 - POST 分页查询扣费记录列表

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回 code
» msg	string	false	none	提示信息
» res	object	true	none	返回参数
»» pageInfo	object	true	none	扣费记录分页数据
»»» total	integer	true	none	总记录数
»»» size	integer	true	none	每页条数
»»» current	integer	true	none	当前页码
»»» elements	[object]	true	none	扣费记录列表
»»»» resourceId	string	false	none	模型平台资源ID
»»»» apiKeyName	string	false	none	API Key名称
»»»» productRuleName	string	false	none	后付费产品规则名称
»»»» billRule	string	false	none	计费规则展示文案
»»»» createTime	string	false	none	扣费记录创建时间
»»»» billRecordCode	string	false	none	扣费记录编号
»»»» startTime	string	false	none	本次计费周期开始时间
»»»» endTime	string	false	none	本次计费周期结束时间
»»»» state	string	false	none	扣费状态,fee_success: "扣费成功",fee_fail: "扣费失败",bundle_deducted: "资源包抵扣",no_fee: "无扣费",fee_wait: "待扣费"
»»»» deductionAmount	number	false	none	扣费金额
»» totalBillAmount	number	true	none	当前查询条件下的账单扣费总额

POST 查询扣费记录详情

POST /xmodel/model/v1/bills/subscribeBillDetail/{billRecordCode}

请求参数 - POST 查询扣费记录详情

名称	位置	类型	必选	说明
billRecordCode	path	string	是	扣费记录编号

{
  "code": "200",
  "res": {
    "billGoodsRecordList": [
      {
        "basicPrice": 0.8,
        "billRecordCode": "pbr-75033941062d3d8cb8ad823ca983a1c3",
        "billingAmount": 0.36,
        "createTime": "2026-06-03 10:50:00",
        "goodsCode": "24009530824073",
        "goodsName": "deepseek-v4-pro_output",
        "modelName": "deepseek-v4-pro",
        "usageAmount": 3759.0,
        "usageAmountUnit": "Token"
      }
    ],
    "resourceBundleRecordList": [
      {
        "billingUnit": "deepseek-v4-pro_input",
        "deductAmount": 0.09,
        "deductTime": "2026-06-03 10:50:00",
        "modelName": "deepseek-v4-pro",
        "remainAmount": 4.53,
        "usageAmount": 43.0,
        "usageAmountUnit": "Token"
      },
      {
        "billingUnit": "deepseek-v4-pro_output",
        "deductAmount": 4.53,
        "deductTime": "2026-06-03 10:50:00",
        "modelName": "deepseek-v4-pro",
        "remainAmount": 0.0,
        "usageAmount": 425.0,
        "usageAmountUnit": "Token"
      }
    ],
    "subscribeBillRecord": {
      "billCode": "A202607031050000786432",
      "code": "pbr-75033941062d3d8cb8ad823ca983a1c3",
      "createTime": "2026-06-03 10:50:00",
      "deductionAmount": 0.36,
      "endTime": "2026-06-03 10:00:00",
      "startTime": "2026-06-03 09:00:00"
    }
  },
  "status": true
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构 - POST 查询扣费记录详情

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回 code
» msg	string	false	none	提示信息
» res	object	true	none	返回参数
»» subscribeBillRecord	object	true	none	后付费扣费主记录
»»» code	string	false	none	扣费记录编号
»»» createTime	string	false	none	创建时间
»»» startTime	string	false	none	计费周期开始时间
»»» endTime	string	false	none	计费周期结束时间
»»» billCode	string	false	none	账单编号
»»» deductionAmount	number	false	none	扣费金额
»» billGoodsRecordList	[object]	true	none	用量商品扣费明细列表
»»» basicPrice	number	false	none	单价
»»» billRecordCode	string	false	none	扣费记录编号
»»» billingAmount	number	false	none	计费金额
»»» createTime	string	false	none	创建时间
»»» goodsCode	string	false	none	商品编码
»»» goodsName	string	false	none	计费单元/商品规则名称
»»» modelName	string	false	none	模型名称
»»» usageAmount	number	false	none	使用量
»»» usageAmountUnit	string	false	none	使用量单位
»» resourceBundleRecordList	[object]	true	none	资源包抵扣明细列表
»»» billingUnit	string	false	none	资源包计费单元
»»» deductAmount	number	false	none	本次抵扣量
»»» deductTime	string	false	none	抵扣时间
»»» modelName	string	false	none	模型名称
»»» remainAmount	number	false	none	抵扣后剩余额度
»»» usageAmount	number	false	none	使用量
»»» usageAmountUnit	string	false	none	使用量单位

Last modified: 06 July 2026