OpenAPI 参考
Modelink API · 管理接口
Modelink 管理接口，用于批量创建 API Key 和导出请求日志。管理接口包含敏感操作与数据，请仅在可信服务端使用。
版本 1.0.0
批量创建 API Key
一次创建 1～100 个 API Key。count 必须与 names 的元素数量一致，每个名称长度为 1～50 个字符。接口使用 AK/SK 请求签名鉴权；部分 Key 创建失败时，响应只包含成功创建的 Key。
认证方式
AK/SK 请求签名，格式为 Qiniu {AccessKey}:{EncodedSign}。签名串包含请求方法、路径、查询参数、Host、Content-Type、X-Qiniu- 请求头以及符合条件的请求体。
请求体
请求体属性
- countinteger, 必填
本次希望创建的 API Key 数量，必须等于
names的元素数量。minimum: 1; maximum: 100
- namesstring[], 必填
API Key 名称列表。
请求
curl https://api.qnaigc.com/v1/apikeys \
--request POST \
--header 'Authorization: YOUR_QINIU_AUTH' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"count": 2,
"names": [
"production-service",
"staging-service"
]
}'响应
创建完成，或请求被业务校验拒绝。请同时检查响应体中的 status。
响应体属性
- oneOf[0]object
additionalProperties: false
- statustrue, 必填必填。
const: true
- dataobject, 必填
additionalProperties: false
- keysobject[], 必填
- keystring, 必填
新创建的 API Key。请安全保存，避免写入日志或公开仓库。
- namestring, 必填
API Key 名称。
- createdAtstring, 必填
创建时间。
- enabledboolean, 必填
API Key 是否已启用。
- oneOf[1]object
additionalProperties: false
- statusfalse, 必填必填。
const: false
- errorstring, 必填
错误标识或错误描述。
响应
{
"status": true,
"data": {
"keys": [
{
"key": "sk-example-1",
"name": "production-service",
"createdAt": "2026-07-18 10:00:00",
"enabled": true
},
{
"key": "sk-example-2",
"name": "staging-service",
"createdAt": "2026-07-18 10:00:00",
"enabled": true
}
]
}
}导出请求日志
按时间、模型、状态码或 API Key 筛选请求日志，以统一响应结构返回 JSON。结果固定按 start_time 倒序排列。单次最多返回 500 条；当 start 和 end 同时传入时，时间跨度不得超过 35 天。
认证方式
在 Authorization 请求头中传入 Modelink API Key，格式为 Bearer {API_KEY}。
查询参数
- Name
- start
- Type
- string<date-time>
- Description
开始时间，RFC 3339 格式，作为左闭边界（大于等于）。
- Name
- end
- Type
- string<date-time>
- Description
结束时间，RFC 3339 格式，作为右开边界（小于）。与
start同时传入时，跨度不得超过 35 天。
- Name
- size
- Type
- integer, 必填
- Description
每页返回的日志数量。
- Name
- page
- Type
- integer
- Description
页码，从 1 开始；不传或小于等于 0 时按第 1 页处理。
- Name
- model
- Type
- string
- Description
按模型 ID 精确筛选。
- Name
- code
- Type
- integer
- Description
按上游 HTTP 状态码精确筛选；0 或不传表示不限制。
- Name
- apikey
- Type
- string
- Description
按 API Key 筛选，同时匹配带或不带
Bearer前缀的日志记录。
请求体
暂无请求体
请求
curl 'https://api.qnaigc.com/v2/stat/export_log?start={start}&end={end}&size={size}&page={page}&model={model}&code={code}&apikey={apikey}' \
--header 'Authorization: Bearer YOUR_BEARER_AUTH' \
--header 'Accept: application/json'响应
日志导出成功；使用 API Key 鉴权失败或发生内部错误时，也可能返回 HTTP 200 和 status: false。
响应体属性
- oneOf[0]object
additionalProperties: false
- statustrue, 必填必填。
const: true
- dataobject[], 必填
- idstring, 必填
日志记录 ID。
- model_idstring, 必填
请求使用的模型 ID。
- api_keystring, 必填
已脱敏的 API Key。
- start_timestring<date-time>, 必填
请求开始时间。
- end_timestring<date-time>, 必填
请求结束时间。
- server_typestring, 必填
服务类型，例如
chat、image或video。 - codeinteger, 必填
上游 HTTP 状态码。
- errorsstring[]
错误信息列表，无错误时为
null。 - statestring
请求状态标识。
- usageobject | null
平台归一化后的用量统计。不同服务可能返回 input、output、cached_input、video_second 等不同字段；它与协议响应中的原始 usage 结构不一定同名。对账方法见 Usage 字段与计费对账。
- inputinteger
归一化后的输入用量。
- outputinteger
归一化后的输出用量。
- cached_inputinteger
命中缓存的输入用量。
- cache_creationinteger
用于创建缓存的输入用量。
- tts_bytesinteger
语音合成处理的字节数。
- asr_msinteger
语音识别处理时长，单位为毫秒。
- ocr_requestsinteger
OCR 请求次数。
- search_requestsinteger
搜索请求次数。
- video_secondinteger
视频用量，单位为秒。
- *integer
其他由服务类型产生的归一化用量。
- bo_usageobject
本次请求实际命中的计费项及计费用量。key 与模型价格配置中的计费项对应，不应把未出现在此对象中的响应明细重复计费。
- input_tokensinteger
输入 Token 计费项的用量。
- output_tokensinteger
输出 Token 计费项的用量。
- *integer
其他由模型价格配置决定的计费项用量。
- bo_usage_costobject
与 bo_usage 同名计费项对应的人民币费用，可将各项金额相加核对本次请求费用。
- input_tokensnumber
输入 Token 计费项的费用，单位为人民币元。
- output_tokensnumber
输出 Token 计费项的费用，单位为人民币元。
- *number
其他同名计费项的费用，单位为人民币元。
- oneOf[1]object
additionalProperties: false
- statusfalse, 必填必填。
const: false
- errorstring, 必填
错误标识或错误描述。
响应
{
"status": true,
"data": [
{
"id": "65a1f2c3",
"model_id": "deepseek/deepseek-v3.1",
"api_key": "sk-***xxxx",
"start_time": "2026-07-18T10:00:00+08:00",
"end_time": "2026-07-18T10:00:02+08:00",
"server_type": "chat",
"code": 200,
"errors": null,
"state": "",
"usage": {
"input": 1024,
"output": 512,
"cached_input": 0,
"cache_creation": 0
},
"bo_usage": {
"input_tokens": 1024,
"output_tokens": 512
},
"bo_usage_cost": {
"input_tokens": 0.001,
"output_tokens": 0.002
}
}
]
}导出请求日志为文件
使用与“导出请求日志”相同的筛选条件，将日志作为 logs.json 文件下载。成功响应体为日志对象裸数组，不包含 status 和 data 包裹。
认证方式
在 Authorization 请求头中传入 Modelink API Key，格式为 Bearer {API_KEY}。
查询参数
- Name
- start
- Type
- string<date-time>
- Description
开始时间，RFC 3339 格式，作为左闭边界（大于等于）。
- Name
- end
- Type
- string<date-time>
- Description
结束时间，RFC 3339 格式，作为右开边界（小于）。与
start同时传入时，跨度不得超过 35 天。
- Name
- size
- Type
- integer, 必填
- Description
每页返回的日志数量。
- Name
- page
- Type
- integer
- Description
页码，从 1 开始；不传或小于等于 0 时按第 1 页处理。
- Name
- model
- Type
- string
- Description
按模型 ID 精确筛选。
- Name
- code
- Type
- integer
- Description
按上游 HTTP 状态码精确筛选；0 或不传表示不限制。
- Name
- apikey
- Type
- string
- Description
按 API Key 筛选，同时匹配带或不带
Bearer前缀的日志记录。
请求体
暂无请求体
请求
curl 'https://api.qnaigc.com/v2/stat/export_log_file?start={start}&end={end}&size={size}&page={page}&model={model}&code={code}&apikey={apikey}' \
--header 'Authorization: Bearer YOUR_BEARER_AUTH' \
--header 'Accept: application/json'响应
JSON 文件下载成功；使用 API Key 鉴权失败或发生内部错误时，也可能返回统一错误 JSON。
响应体属性
- oneOf[0]object[]
- idstring, 必填
日志记录 ID。
- model_idstring, 必填
请求使用的模型 ID。
- api_keystring, 必填
已脱敏的 API Key。
- start_timestring<date-time>, 必填
请求开始时间。
- end_timestring<date-time>, 必填
请求结束时间。
- server_typestring, 必填
服务类型，例如
chat、image或video。 - codeinteger, 必填
上游 HTTP 状态码。
- errorsstring[]
错误信息列表，无错误时为
null。 - statestring
请求状态标识。
- usageobject | null
平台归一化后的用量统计。不同服务可能返回 input、output、cached_input、video_second 等不同字段；它与协议响应中的原始 usage 结构不一定同名。对账方法见 Usage 字段与计费对账。
- inputinteger
归一化后的输入用量。
- outputinteger
归一化后的输出用量。
- cached_inputinteger
命中缓存的输入用量。
- cache_creationinteger
用于创建缓存的输入用量。
- tts_bytesinteger
语音合成处理的字节数。
- asr_msinteger
语音识别处理时长，单位为毫秒。
- ocr_requestsinteger
OCR 请求次数。
- search_requestsinteger
搜索请求次数。
- video_secondinteger
视频用量，单位为秒。
- *integer
其他由服务类型产生的归一化用量。
- bo_usageobject
本次请求实际命中的计费项及计费用量。key 与模型价格配置中的计费项对应，不应把未出现在此对象中的响应明细重复计费。
- input_tokensinteger
输入 Token 计费项的用量。
- output_tokensinteger
输出 Token 计费项的用量。
- *integer
其他由模型价格配置决定的计费项用量。
- bo_usage_costobject
与 bo_usage 同名计费项对应的人民币费用，可将各项金额相加核对本次请求费用。
- input_tokensnumber
输入 Token 计费项的费用，单位为人民币元。
- output_tokensnumber
输出 Token 计费项的费用，单位为人民币元。
- *number
其他同名计费项的费用，单位为人民币元。
- oneOf[1]object
additionalProperties: false
- statusfalse, 必填必填。
const: false
- errorstring, 必填
错误标识或错误描述。
响应
[
{
"id": "65a1f2c3",
"model_id": "deepseek/deepseek-v3.1",
"api_key": "sk-***xxxx",
"start_time": "2026-07-18T10:00:00+08:00",
"end_time": "2026-07-18T10:00:02+08:00",
"server_type": "chat",
"code": 200,
"errors": null,
"state": "",
"usage": {
"input": 1024,
"output": 512,
"cached_input": 0,
"cache_creation": 0
},
"bo_usage": {
"input_tokens": 1024,
"output_tokens": 512
},
"bo_usage_cost": {
"input_tokens": 0.001,
"output_tokens": 0.002
}
}
]'%3e%3cpath%20d='M44.867217,0.0054376148%20C130.715579,1.00591567%20200,70.9091172%20200,156.994562%20L199.986321,155.127494%20C199.384888,180.009127%20179.026368,199.994562%20154,199.994562%20L46,199.994562%20C20.5949015,199.994562%200,179.399661%200,153.994562%20L0,45.9945624%20C0,21.0975659%2019.7793434,0.820282524%2044.4815926,0.0191499894%20Z'%20fill='%2300D492'%3e%3c/path%3e%3cpath%20d='M123.867217,0.0054376148%20C209.715579,1.00591567%20279,70.9091172%20279,156.994562%20L278.986321,155.127494%20C278.384888,180.009127%20258.026368,199.994562%20233,199.994562%20L125,199.994562%20C99.5949015,199.994562%2079,179.399661%2079,153.994562%20L79,45.9945624%20C79,21.0975659%2098.7793434,0.820282524%20123.481593,0.0191499894%20Z'%20id='clarify-right'%20fill-opacity='0.6'%20fill='%2300F6C9'%20transform='translate(179,%20100)%20rotate(-90)%20translate(-179,%20-100)'%3e%3c/path%3e%3cpath%20d='M199.979267,154.416906%20L199.984438,155.157125%20L199.962366,155.872459%20C198.977251,180.406837%20178.776104,199.994562%20154,199.994562%20L124.372438,199.994125%20L124.249053,199.994081%20C99.6939678,199.603921%2079.8122712,179.973634%2079.01915,155.518407%20L79.0054376,155.132783%20C79.5830823,105.566626%20103.129768,61.5221348%20139.498462,33.1463428%20C175.69419,61.3871018%20199.186123,105.143863%20199.979267,154.416906%20Z'%20id='形状结合'%20fill='%2300F692'%3e%3c/path%3e%3c/g%3e%3c/g%3e%3c/svg%3e)