[{"data":1,"prerenderedAt":2361},["ShallowReactive",2],{"docs-navigation-zh-CN":3,"/docs/api/conventions":73,"/docs/api/conventions-surround":2356},[4],{"title":5,"path":6,"stem":7,"children":8,"page":26},"Docs","/docs","docs",[9,27,56,65],{"title":10,"path":11,"stem":12,"children":13,"page":26},"入门","/docs/start","docs/1.start",[14,18,22],{"title":15,"path":16,"stem":17},"快速开始","/docs/start/quick-start","docs/1.start/1.quick-start",{"title":19,"path":20,"stem":21},"选型指南","/docs/start/guide","docs/1.start/2.guide",{"title":23,"path":24,"stem":25},"术语表","/docs/start/glossary","docs/1.start/3.glossary",false,{"title":28,"path":29,"stem":30,"children":31,"page":26},"开放 API","/docs/api","docs/2.api",[32,36,40,44,48,52],{"title":33,"path":34,"stem":35},"V1 API 通用约定","/docs/api/conventions","docs/2.api/1.conventions",{"title":37,"path":38,"stem":39},"模型 API","/docs/api/models","docs/2.api/2.models",{"title":41,"path":42,"stem":43},"文本 API","/docs/api/text","docs/2.api/3.text",{"title":45,"path":46,"stem":47},"图像 API","/docs/api/images","docs/2.api/4.images",{"title":49,"path":50,"stem":51},"视频 API","/docs/api/videos","docs/2.api/5.videos",{"title":53,"path":54,"stem":55},"音频 API","/docs/api/audio","docs/2.api/6.audio",{"title":57,"path":58,"stem":59,"children":60,"page":26},"MCP 服务","/docs/mcp","docs/3.mcp",[61],{"title":62,"path":63,"stem":64},"MCP 连接与配置","/docs/mcp/connection","docs/3.mcp/1.connection",{"title":66,"path":67,"stem":68,"children":69,"page":26},"Skills","/docs/skills","docs/4.skills",[70],{"title":66,"path":71,"stem":72},"/docs/skills/skills-intro","docs/4.skills/1.skills-intro",{"id":74,"title":33,"body":75,"description":2350,"extension":2351,"meta":2352,"navigation":2353,"path":34,"seo":2354,"stem":35,"__hash__":2355},"docs/docs/2.api/1.conventions.md",{"type":76,"value":77,"toc":2324},"minimark",[78,87,102,105,109,114,124,130,133,139,153,220,237,241,304,307,324,326,329,336,339,524,530,613,615,618,622,642,772,857,861,867,915,953,965,969,977,1021,1061,1063,1066,1076,1117,1130,1132,1138,1141,1147,1151,1154,1158,1189,1192,1196,1340,1343,1443,1445,1450,1465,1471,1474,1640,1643,1671,1674,1678,2024,2027,2274,2276,2279,2320],[79,80,81,82,86],"p",{},"本文说明 V1 开放 API（",[83,84,85],"code",{},"/v1/*","）的鉴权、计费、公共对象与错误响应格式。",[79,88,89,93,94,97,98,101],{},[90,91,92],"strong",{},"适用范围","：对外开放的 ",[83,95,96],{},"/v1"," Relay 接口，共 ",[90,99,100],{},"12 条","。",[103,104],"hr",{},[106,107,108],"h2",{"id":108},"通用约定",[110,111,113],"h3",{"id":112},"base-url","Base URL",[115,116,121],"pre",{"className":117,"code":119,"language":120},[118],"language-text","https://www.yunsell.com\n","text",[83,122,119],{"__ignoreMap":123},"",[79,125,126,127,101],{},"接口直接挂载在域名根路径，例如 ",[83,128,129],{},"POST https://www.yunsell.com/v1/chat/completions",[110,131,132],{"id":132},"鉴权",[79,134,135,136,138],{},"全部 ",[83,137,96],{}," 公开接口统一使用 Bearer Token：",[115,140,144],{"className":141,"code":142,"language":143,"meta":123,"style":123},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Authorization: Bearer sk-xxxxxxxxxxxxxxxx\n","http",[83,145,146],{"__ignoreMap":123},[147,148,151],"span",{"class":149,"line":150},"line",1,[147,152,142],{},[154,155,156,169],"table",{},[157,158,159],"thead",{},[160,161,162,166],"tr",{},[163,164,165],"th",{},"规则",[163,167,168],{},"说明",[170,171,172,181,189,205],"tbody",{},[160,173,174,178],{},[175,176,177],"td",{},"令牌校验",[175,179,180],{},"校验 API Key 有效性、用户状态、余额/配额",[160,182,183,186],{},[175,184,185],{},"IP 白名单",[175,187,188],{},"若令牌配置了 IP 白名单，则校验请求来源",[160,190,191,194],{},[175,192,193],{},"指定渠道",[175,195,196,197,200,201,204],{},"管理员可在 Key 后追加 ",[83,198,199],{},"-{channelId}","（如 ",[83,202,203],{},"sk-xxx-6","）；普通用户禁止",[160,206,207,210],{},[175,208,209],{},"鉴权失败",[175,211,212,213,216,217],{},"返回 HTTP ",[83,214,215],{},"401"," / ",[83,218,219],{},"403",[79,221,222,225,226,229,230,233,234,101],{},[90,223,224],{},"例外","：",[83,227,228],{},"GET /v1/videos/{task_id}/content"," 同时支持 ",[90,231,232],{},"管理台 Session"," 与 ",[90,235,236],{},"Bearer Token",[110,238,240],{"id":239},"content-type","Content-Type",[154,242,243,252],{},[157,244,245],{},[160,246,247,250],{},[163,248,249],{},"场景",[163,251,240],{},[170,253,254,264,274,293],{},[160,255,256,259],{},[175,257,258],{},"JSON 请求",[175,260,261],{},[83,262,263],{},"application/json",[160,265,266,269],{},[175,267,268],{},"图像编辑 / 带文件的视频创建",[175,270,271],{},[83,272,273],{},"multipart/form-data",[160,275,276,279],{},[175,277,278],{},"TTS 响应",[175,280,281,284,285,288,289,292],{},[83,282,283],{},"audio/mpeg","、",[83,286,287],{},"audio/wav"," 等（取决于 ",[83,290,291],{},"response_format","）",[160,294,295,298],{},[175,296,297],{},"Chat / Responses 流式",[175,299,300,303],{},[83,301,302],{},"text/event-stream","（SSE）",[110,305,306],{"id":306},"计费",[308,309,310,318,321],"ul",{},[311,312,313,314,317],"li",{},"网关根据请求体中的 ",[83,315,316],{},"model","（或路径参数）自动选择上游渠道",[311,319,320],{},"支持按 Token、按次、按秒等计费策略",[311,322,323],{},"不同 API Key 可见模型列表可能不同",[103,325],{},[106,327,328],{"id":328},"公共响应对象",[110,330,332,335],{"id":331},"usagetoken-计费",[83,333,334],{},"usage","（Token 计费）",[79,337,338],{},"文本类接口（Chat / Completions / Responses）响应中常见：",[154,340,341,353],{},[157,342,343],{},[160,344,345,348,351],{},[163,346,347],{},"字段",[163,349,350],{},"类型",[163,352,168],{},[170,354,355,368,380,392,404,416,428,441,453,465,477,489,501,513],{},[160,356,357,362,365],{},[175,358,359],{},[83,360,361],{},"prompt_tokens",[175,363,364],{},"integer",[175,366,367],{},"输入 Token 数（Completions / Chat）",[160,369,370,375,377],{},[175,371,372],{},[83,373,374],{},"completion_tokens",[175,376,364],{},[175,378,379],{},"输出 Token 数（Completions / Chat）",[160,381,382,387,389],{},[175,383,384],{},[83,385,386],{},"total_tokens",[175,388,364],{},[175,390,391],{},"总 Token 数",[160,393,394,399,401],{},[175,395,396],{},[83,397,398],{},"input_tokens",[175,400,364],{},[175,402,403],{},"输入 Token 数（Responses）",[160,405,406,411,413],{},[175,407,408],{},[83,409,410],{},"output_tokens",[175,412,364],{},[175,414,415],{},"输出 Token 数（Responses）",[160,417,418,423,425],{},[175,419,420],{},[83,421,422],{},"prompt_cache_hit_tokens",[175,424,364],{},[175,426,427],{},"命中缓存的输入 Token（部分模型）",[160,429,430,435,438],{},[175,431,432],{},[83,433,434],{},"prompt_tokens_details",[175,436,437],{},"object",[175,439,440],{},"输入 Token 明细",[160,442,443,448,450],{},[175,444,445],{},[83,446,447],{},"prompt_tokens_details.cached_tokens",[175,449,364],{},[175,451,452],{},"缓存 Token 数",[160,454,455,460,462],{},[175,456,457],{},[83,458,459],{},"prompt_tokens_details.text_tokens",[175,461,364],{},[175,463,464],{},"文本 Token 数",[160,466,467,472,474],{},[175,468,469],{},[83,470,471],{},"prompt_tokens_details.audio_tokens",[175,473,364],{},[175,475,476],{},"音频 Token 数",[160,478,479,484,486],{},[175,480,481],{},[83,482,483],{},"prompt_tokens_details.image_tokens",[175,485,364],{},[175,487,488],{},"图像 Token 数",[160,490,491,496,498],{},[175,492,493],{},[83,494,495],{},"completion_tokens_details",[175,497,437],{},[175,499,500],{},"输出 Token 明细",[160,502,503,508,510],{},[175,504,505],{},[83,506,507],{},"completion_tokens_details.reasoning_tokens",[175,509,364],{},[175,511,512],{},"推理 Token 数",[160,514,515,520,522],{},[175,516,517],{},[83,518,519],{},"completion_tokens_details.text_tokens",[175,521,364],{},[175,523,464],{},[110,525,527,529],{"id":526},"usage按次计费图像",[83,528,334],{},"（按次计费，图像）",[154,531,532,542],{},[157,533,534],{},[160,535,536,538,540],{},[163,537,347],{},[163,539,350],{},[163,541,168],{},[170,543,544,556,568,580,591,602],{},[160,545,546,551,553],{},[175,547,548],{},[83,549,550],{},"quota_type",[175,552,364],{},[175,554,555],{},"计费类型标识",[160,557,558,563,565],{},[175,559,560],{},[83,561,562],{},"quota",[175,564,364],{},[175,566,567],{},"本次消耗额度",[160,569,570,575,577],{},[175,571,572],{},[83,573,574],{},"request_count",[175,576,364],{},[175,578,579],{},"请求次数，通常为 1",[160,581,582,586,588],{},[175,583,584],{},[83,585,361],{},[175,587,364],{},[175,589,590],{},"输入 Token（图像接口通常为 0）",[160,592,593,597,599],{},[175,594,595],{},[83,596,374],{},[175,598,364],{},[175,600,601],{},"输出 Token（图像接口通常为 0）",[160,603,604,608,610],{},[175,605,606],{},[83,607,386],{},[175,609,364],{},[175,611,612],{},"总 Token（图像接口通常为 0）",[103,614],{},[106,616,617],{"id":617},"错误响应",[110,619,621],{"id":620},"标准错误文本-图像-音频-视频-content","标准错误（文本 / 图像 / 音频 / 视频 content）",[79,623,624,625,284,628,284,630,284,632,284,635,284,638,641],{},"HTTP 状态码：",[83,626,627],{},"400",[83,629,215],{},[83,631,219],{},[83,633,634],{},"404",[83,636,637],{},"429",[83,639,640],{},"500"," 等。",[115,643,647],{"className":644,"code":645,"language":646,"meta":123,"style":123},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"error\": {\n    \"message\": \"Invalid request\",\n    \"type\": \"invalid_request_error\",\n    \"code\": \"invalid_request\",\n    \"param\": \"model\"\n  }\n}\n","json",[83,648,649,655,674,700,721,741,760,766],{"__ignoreMap":123},[147,650,651],{"class":149,"line":150},[147,652,654],{"class":653},"sMK4o","{\n",[147,656,658,661,665,668,671],{"class":149,"line":657},2,[147,659,660],{"class":653},"  \"",[147,662,664],{"class":663},"spNyl","error",[147,666,667],{"class":653},"\"",[147,669,670],{"class":653},":",[147,672,673],{"class":653}," {\n",[147,675,677,680,684,686,688,691,695,697],{"class":149,"line":676},3,[147,678,679],{"class":653},"    \"",[147,681,683],{"class":682},"sBMFI","message",[147,685,667],{"class":653},[147,687,670],{"class":653},[147,689,690],{"class":653}," \"",[147,692,694],{"class":693},"sfazB","Invalid request",[147,696,667],{"class":653},[147,698,699],{"class":653},",\n",[147,701,703,705,708,710,712,714,717,719],{"class":149,"line":702},4,[147,704,679],{"class":653},[147,706,707],{"class":682},"type",[147,709,667],{"class":653},[147,711,670],{"class":653},[147,713,690],{"class":653},[147,715,716],{"class":693},"invalid_request_error",[147,718,667],{"class":653},[147,720,699],{"class":653},[147,722,724,726,728,730,732,734,737,739],{"class":149,"line":723},5,[147,725,679],{"class":653},[147,727,83],{"class":682},[147,729,667],{"class":653},[147,731,670],{"class":653},[147,733,690],{"class":653},[147,735,736],{"class":693},"invalid_request",[147,738,667],{"class":653},[147,740,699],{"class":653},[147,742,744,746,749,751,753,755,757],{"class":149,"line":743},6,[147,745,679],{"class":653},[147,747,748],{"class":682},"param",[147,750,667],{"class":653},[147,752,670],{"class":653},[147,754,690],{"class":653},[147,756,316],{"class":693},[147,758,759],{"class":653},"\"\n",[147,761,763],{"class":149,"line":762},7,[147,764,765],{"class":653},"  }\n",[147,767,769],{"class":149,"line":768},8,[147,770,771],{"class":653},"}\n",[154,773,774,784],{},[157,775,776],{},[160,777,778,780,782],{},[163,779,347],{},[163,781,350],{},[163,783,168],{},[170,785,786,799,816,833,845],{},[160,787,788,793,796],{},[175,789,790],{},[83,791,792],{},"error.message",[175,794,795],{},"string",[175,797,798],{},"人类可读的错误描述",[160,800,801,806,808],{},[175,802,803],{},[83,804,805],{},"error.type",[175,807,795],{},[175,809,810,811,284,813],{},"错误类型，如 ",[83,812,716],{},[83,814,815],{},"insufficient_quota",[160,817,818,823,825],{},[175,819,820],{},[83,821,822],{},"error.code",[175,824,795],{},[175,826,827,828,284,830],{},"错误码，如 ",[83,829,736],{},[83,831,832],{},"model_not_found",[160,834,835,840,842],{},[175,836,837],{},[83,838,839],{},"error.param",[175,841,795],{},[175,843,844],{},"引发错误的请求字段名（若有）",[160,846,847,852,854],{},[175,848,849],{},[83,850,851],{},"error.metadata",[175,853,437],{},[175,855,856],{},"扩展元数据（部分上游返回）",[110,858,860],{"id":859},"任务类错误视频任务创建-查询失败","任务类错误（视频任务创建 / 查询失败）",[79,862,624,863,284,865,641],{},[83,864,627],{},[83,866,637],{},[115,868,870],{"className":644,"code":869,"language":646,"meta":123,"style":123},"{\n  \"code\": \"invalid_request\",\n  \"message\": \"model is required\"\n}\n",[83,871,872,876,894,911],{"__ignoreMap":123},[147,873,874],{"class":149,"line":150},[147,875,654],{"class":653},[147,877,878,880,882,884,886,888,890,892],{"class":149,"line":657},[147,879,660],{"class":653},[147,881,83],{"class":663},[147,883,667],{"class":653},[147,885,670],{"class":653},[147,887,690],{"class":653},[147,889,736],{"class":693},[147,891,667],{"class":653},[147,893,699],{"class":653},[147,895,896,898,900,902,904,906,909],{"class":149,"line":676},[147,897,660],{"class":653},[147,899,683],{"class":663},[147,901,667],{"class":653},[147,903,670],{"class":653},[147,905,690],{"class":653},[147,907,908],{"class":693},"model is required",[147,910,759],{"class":653},[147,912,913],{"class":149,"line":702},[147,914,771],{"class":653},[154,916,917,927],{},[157,918,919],{},[160,920,921,923,925],{},[163,922,347],{},[163,924,350],{},[163,926,168],{},[170,928,929,942],{},[160,930,931,935,937],{},[175,932,933],{},[83,934,83],{},[175,936,795],{},[175,938,939,940],{},"错误码，常见 ",[83,941,736],{},[160,943,944,948,950],{},[175,945,946],{},[83,947,683],{},[175,949,795],{},[175,951,952],{},"错误描述",[79,954,955,956,958,959,961,962,101],{},"HTTP ",[83,957,637],{}," 时 ",[83,960,683],{}," 为：",[83,963,964],{},"当前分组上游负载已饱和，请稍后再试",[110,966,968],{"id":967},"网关扩展错误模型列表音色列表等","网关扩展错误（模型列表、音色列表等）",[79,970,624,971,974,975,101],{},[83,972,973],{},"200","（业务失败）或 ",[83,976,627],{},[115,978,980],{"className":644,"code":979,"language":646,"meta":123,"style":123},"{\n  \"success\": false,\n  \"message\": \"get user group failed\"\n}\n",[83,981,982,986,1000,1017],{"__ignoreMap":123},[147,983,984],{"class":149,"line":150},[147,985,654],{"class":653},[147,987,988,990,993,995,997],{"class":149,"line":657},[147,989,660],{"class":653},[147,991,992],{"class":663},"success",[147,994,667],{"class":653},[147,996,670],{"class":653},[147,998,999],{"class":653}," false,\n",[147,1001,1002,1004,1006,1008,1010,1012,1015],{"class":149,"line":676},[147,1003,660],{"class":653},[147,1005,683],{"class":663},[147,1007,667],{"class":653},[147,1009,670],{"class":653},[147,1011,690],{"class":653},[147,1013,1014],{"class":693},"get user group failed",[147,1016,759],{"class":653},[147,1018,1019],{"class":149,"line":702},[147,1020,771],{"class":653},[154,1022,1023,1033],{},[157,1024,1025],{},[160,1026,1027,1029,1031],{},[163,1028,347],{},[163,1030,350],{},[163,1032,168],{},[170,1034,1035,1051],{},[160,1036,1037,1041,1044],{},[175,1038,1039],{},[83,1040,992],{},[175,1042,1043],{},"boolean",[175,1045,1046,1047,1050],{},"是否成功，",[83,1048,1049],{},"false"," 表示失败",[160,1052,1053,1057,1059],{},[175,1054,1055],{},[83,1056,683],{},[175,1058,795],{},[175,1060,952],{},[103,1062],{},[106,1064,1065],{"id":1065},"令牌余额与消费记录",[79,1067,1068,1069,1071,1072,1075],{},"除 Relay 接口外，V1 还提供两条查询接口，鉴权方式与其它 ",[83,1070,96],{}," 接口一致：",[83,1073,1074],{},"Authorization: Bearer sk-xxxxxxxx","。仅可查询当前 Bearer 令牌自身的数据。",[154,1077,1078,1090],{},[157,1079,1080],{},[160,1081,1082,1085,1088],{},[163,1083,1084],{},"方法",[163,1086,1087],{},"路径",[163,1089,168],{},[170,1091,1092,1105],{},[160,1093,1094,1097,1102],{},[175,1095,1096],{},"GET",[175,1098,1099],{},[83,1100,1101],{},"/v1/token/balance",[175,1103,1104],{},"查询令牌余额（⚡）",[160,1106,1107,1109,1114],{},[175,1108,1096],{},[175,1110,1111],{},[83,1112,1113],{},"/v1/token/consume",[175,1115,1116],{},"查询当前 API Key 消费记录（分页）",[1118,1119,1120],"blockquote",{},[79,1121,1122,1125,1126,1129],{},[90,1123,1124],{},"鉴权方式","：统一使用 Bearer Token，令牌信息由鉴权中间件解析，无需再传 ",[83,1127,1128],{},"key"," 参数。",[103,1131],{},[110,1133,1135,1136],{"id":1134},"get-v1tokenbalance","GET ",[83,1137,1101],{},[79,1139,1140],{},"查询当前 Bearer 令牌的余额，返回以 ⚡ 为单位的剩余额度与已用额度。",[79,1142,1143,225,1145],{},[90,1144,132],{},[83,1146,1074],{},[1148,1149,1150],"h4",{"id":1150},"请求参数",[79,1152,1153],{},"无 query 参数。",[1148,1155,1157],{"id":1156},"请求示例curl","请求示例（curl）",[115,1159,1163],{"className":1160,"code":1161,"language":1162,"meta":123,"style":123},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl https://www.yunsell.com/v1/token/balance \\\n  -H \"Authorization: Bearer sk-xxxxx\"\n","bash",[83,1164,1165,1177],{"__ignoreMap":123},[147,1166,1167,1170,1173],{"class":149,"line":150},[147,1168,1169],{"class":682},"curl",[147,1171,1172],{"class":693}," https://www.yunsell.com/v1/token/balance",[147,1174,1176],{"class":1175},"sTEyZ"," \\\n",[147,1178,1179,1182,1184,1187],{"class":149,"line":657},[147,1180,1181],{"class":693},"  -H",[147,1183,690],{"class":653},[147,1185,1186],{"class":693},"Authorization: Bearer sk-xxxxx",[147,1188,759],{"class":653},[1148,1190,1191],{"id":1191},"响应体",[79,1193,955,1194],{},[83,1195,973],{},[115,1197,1199],{"className":644,"code":1198,"language":646,"meta":123,"style":123},"{\n  \"success\": true,\n  \"message\": \"\",\n  \"data\": {\n    \"id\": 1,\n    \"name\": \"API Token\",\n    \"remain_quota_usd\": 0.2,\n    \"used_quota_usd\": 0.1,\n    \"unlimited_quota\": false\n  }\n}\n",[83,1200,1201,1205,1218,1233,1246,1263,1283,1299,1315,1330,1335],{"__ignoreMap":123},[147,1202,1203],{"class":149,"line":150},[147,1204,654],{"class":653},[147,1206,1207,1209,1211,1213,1215],{"class":149,"line":657},[147,1208,660],{"class":653},[147,1210,992],{"class":663},[147,1212,667],{"class":653},[147,1214,670],{"class":653},[147,1216,1217],{"class":653}," true,\n",[147,1219,1220,1222,1224,1226,1228,1231],{"class":149,"line":676},[147,1221,660],{"class":653},[147,1223,683],{"class":663},[147,1225,667],{"class":653},[147,1227,670],{"class":653},[147,1229,1230],{"class":653}," \"\"",[147,1232,699],{"class":653},[147,1234,1235,1237,1240,1242,1244],{"class":149,"line":702},[147,1236,660],{"class":653},[147,1238,1239],{"class":663},"data",[147,1241,667],{"class":653},[147,1243,670],{"class":653},[147,1245,673],{"class":653},[147,1247,1248,1250,1253,1255,1257,1261],{"class":149,"line":723},[147,1249,679],{"class":653},[147,1251,1252],{"class":682},"id",[147,1254,667],{"class":653},[147,1256,670],{"class":653},[147,1258,1260],{"class":1259},"sbssI"," 1",[147,1262,699],{"class":653},[147,1264,1265,1267,1270,1272,1274,1276,1279,1281],{"class":149,"line":743},[147,1266,679],{"class":653},[147,1268,1269],{"class":682},"name",[147,1271,667],{"class":653},[147,1273,670],{"class":653},[147,1275,690],{"class":653},[147,1277,1278],{"class":693},"API Token",[147,1280,667],{"class":653},[147,1282,699],{"class":653},[147,1284,1285,1287,1290,1292,1294,1297],{"class":149,"line":762},[147,1286,679],{"class":653},[147,1288,1289],{"class":682},"remain_quota_usd",[147,1291,667],{"class":653},[147,1293,670],{"class":653},[147,1295,1296],{"class":1259}," 0.2",[147,1298,699],{"class":653},[147,1300,1301,1303,1306,1308,1310,1313],{"class":149,"line":768},[147,1302,679],{"class":653},[147,1304,1305],{"class":682},"used_quota_usd",[147,1307,667],{"class":653},[147,1309,670],{"class":653},[147,1311,1312],{"class":1259}," 0.1",[147,1314,699],{"class":653},[147,1316,1318,1320,1323,1325,1327],{"class":149,"line":1317},9,[147,1319,679],{"class":653},[147,1321,1322],{"class":682},"unlimited_quota",[147,1324,667],{"class":653},[147,1326,670],{"class":653},[147,1328,1329],{"class":653}," false\n",[147,1331,1333],{"class":149,"line":1332},10,[147,1334,765],{"class":653},[147,1336,1338],{"class":149,"line":1337},11,[147,1339,771],{"class":653},[1148,1341,1342],{"id":1342},"响应字段",[154,1344,1345,1355],{},[157,1346,1347],{},[160,1348,1349,1351,1353],{},[163,1350,347],{},[163,1352,350],{},[163,1354,168],{},[170,1356,1357,1368,1379,1391,1403,1419,1431],{},[160,1358,1359,1363,1365],{},[175,1360,1361],{},[83,1362,992],{},[175,1364,1043],{},[175,1366,1367],{},"是否成功",[160,1369,1370,1374,1376],{},[175,1371,1372],{},[83,1373,683],{},[175,1375,795],{},[175,1377,1378],{},"提示信息",[160,1380,1381,1386,1388],{},[175,1382,1383],{},[83,1384,1385],{},"data.id",[175,1387,364],{},[175,1389,1390],{},"令牌 ID",[160,1392,1393,1398,1400],{},[175,1394,1395],{},[83,1396,1397],{},"data.name",[175,1399,795],{},[175,1401,1402],{},"令牌名称",[160,1404,1405,1410,1413],{},[175,1406,1407],{},[83,1408,1409],{},"data.remain_quota_usd",[175,1411,1412],{},"number",[175,1414,1415,1416],{},"剩余额度（⚡）。无限额度令牌固定返回 ",[83,1417,1418],{},"0",[160,1420,1421,1426,1428],{},[175,1422,1423],{},[83,1424,1425],{},"data.used_quota_usd",[175,1427,1412],{},[175,1429,1430],{},"已用额度（⚡）",[160,1432,1433,1438,1440],{},[175,1434,1435],{},[83,1436,1437],{},"data.unlimited_quota",[175,1439,1043],{},[175,1441,1442],{},"是否无限额度",[103,1444],{},[110,1446,1135,1448],{"id":1447},"get-v1tokenconsume",[83,1449,1113],{},[79,1451,1452,1453,1456,1457,1460,1461,1464],{},"分页查询",[90,1454,1455],{},"当前 Bearer API Key"," 的消费记录（仅 ",[83,1458,1459],{},"type = 2"," 消费）。按 ",[83,1462,1463],{},"token_id"," 过滤，不返回所属用户的充值 / 收入等钱包类记录，也不汇总该用户下其它 Key 的消费。",[79,1466,1467,225,1469],{},[90,1468,132],{},[83,1470,1074],{},[1148,1472,1150],{"id":1473},"请求参数-1",[154,1475,1476,1490],{},[157,1477,1478],{},[160,1479,1480,1483,1485,1488],{},[163,1481,1482],{},"参数",[163,1484,350],{},[163,1486,1487],{},"必填",[163,1489,168],{},[170,1491,1492,1510,1531,1567,1583,1598,1612,1626],{},[160,1493,1494,1499,1501,1504],{},[175,1495,1496],{},[83,1497,1498],{},"page",[175,1500,364],{},[175,1502,1503],{},"否",[175,1505,1506,1507],{},"页码，默认 ",[83,1508,1509],{},"1",[160,1511,1512,1517,1519,1521],{},[175,1513,1514],{},[83,1515,1516],{},"page_size",[175,1518,364],{},[175,1520,1503],{},[175,1522,1523,1524,1527,1528],{},"每页条数，默认 ",[83,1525,1526],{},"10","，最大 ",[83,1529,1530],{},"100",[160,1532,1533,1538,1540,1542],{},[175,1534,1535],{},[83,1536,1537],{},"time_range",[175,1539,795],{},[175,1541,1503],{},[175,1543,1544,1545,284,1548,284,1551,284,1554,284,1557,1560,1561,216,1564],{},"时间范围快捷筛选，仅允许 ",[83,1546,1547],{},"all",[83,1549,1550],{},"today",[83,1552,1553],{},"yesterday",[83,1555,1556],{},"week",[83,1558,1559],{},"month","。优先级高于 ",[83,1562,1563],{},"start_timestamp",[83,1565,1566],{},"end_timestamp",[160,1568,1569,1573,1575,1577],{},[175,1570,1571],{},[83,1572,1563],{},[175,1574,364],{},[175,1576,1503],{},[175,1578,1579,1580,1582],{},"开始时间戳（",[83,1581,1537],{}," 为空时生效）",[160,1584,1585,1589,1591,1593],{},[175,1586,1587],{},[83,1588,1566],{},[175,1590,364],{},[175,1592,1503],{},[175,1594,1595,1596,1582],{},"结束时间戳（",[83,1597,1537],{},[160,1599,1600,1605,1607,1609],{},[175,1601,1602],{},[83,1603,1604],{},"model_name",[175,1606,795],{},[175,1608,1503],{},[175,1610,1611],{},"模型名称筛选",[160,1613,1614,1619,1621,1623],{},[175,1615,1616],{},[83,1617,1618],{},"request_id",[175,1620,795],{},[175,1622,1503],{},[175,1624,1625],{},"请求 ID 筛选",[160,1627,1628,1633,1635,1637],{},[175,1629,1630],{},[83,1631,1632],{},"upstream_request_id",[175,1634,795],{},[175,1636,1503],{},[175,1638,1639],{},"上游请求 ID 筛选",[1148,1641,1157],{"id":1642},"请求示例curl-1",[115,1644,1646],{"className":1160,"code":1645,"language":1162,"meta":123,"style":123},"curl \"https://www.yunsell.com/v1/token/consume?page=1&page_size=10&time_range=today\" \\\n  -H \"Authorization: Bearer sk-xxxxx\"\n",[83,1647,1648,1661],{"__ignoreMap":123},[147,1649,1650,1652,1654,1657,1659],{"class":149,"line":150},[147,1651,1169],{"class":682},[147,1653,690],{"class":653},[147,1655,1656],{"class":693},"https://www.yunsell.com/v1/token/consume?page=1&page_size=10&time_range=today",[147,1658,667],{"class":653},[147,1660,1176],{"class":1175},[147,1662,1663,1665,1667,1669],{"class":149,"line":657},[147,1664,1181],{"class":693},[147,1666,690],{"class":653},[147,1668,1186],{"class":693},[147,1670,759],{"class":653},[1148,1672,1191],{"id":1673},"响应体-1",[79,1675,955,1676],{},[83,1677,973],{},[115,1679,1681],{"className":644,"code":1680,"language":646,"meta":123,"style":123},"{\n  \"success\": true,\n  \"message\": \"\",\n  \"code\": 0,\n  \"data\": {\n    \"page\": 1,\n    \"page_size\": 10,\n    \"total\": 100,\n    \"items\": [\n      {\n        \"id\": 1,\n        \"created_at\": 1700000000,\n        \"type\": 2,\n        \"type_name\": \"消费\",\n        \"content\": \"模型推理\",\n        \"token_name\": \"default\",\n        \"model_name\": \"gpt-3.5-turbo\",\n        \"app_name\": \"\",\n        \"usage_name\": \"gpt-3.5-turbo\",\n        \"quota_usd\": 0.002,\n        \"quota_type\": 2\n      }\n    ]\n  }\n}\n",[83,1682,1683,1687,1699,1713,1728,1740,1754,1769,1785,1799,1804,1819,1836,1852,1873,1894,1915,1935,1951,1971,1988,2002,2008,2014,2019],{"__ignoreMap":123},[147,1684,1685],{"class":149,"line":150},[147,1686,654],{"class":653},[147,1688,1689,1691,1693,1695,1697],{"class":149,"line":657},[147,1690,660],{"class":653},[147,1692,992],{"class":663},[147,1694,667],{"class":653},[147,1696,670],{"class":653},[147,1698,1217],{"class":653},[147,1700,1701,1703,1705,1707,1709,1711],{"class":149,"line":676},[147,1702,660],{"class":653},[147,1704,683],{"class":663},[147,1706,667],{"class":653},[147,1708,670],{"class":653},[147,1710,1230],{"class":653},[147,1712,699],{"class":653},[147,1714,1715,1717,1719,1721,1723,1726],{"class":149,"line":702},[147,1716,660],{"class":653},[147,1718,83],{"class":663},[147,1720,667],{"class":653},[147,1722,670],{"class":653},[147,1724,1725],{"class":1259}," 0",[147,1727,699],{"class":653},[147,1729,1730,1732,1734,1736,1738],{"class":149,"line":723},[147,1731,660],{"class":653},[147,1733,1239],{"class":663},[147,1735,667],{"class":653},[147,1737,670],{"class":653},[147,1739,673],{"class":653},[147,1741,1742,1744,1746,1748,1750,1752],{"class":149,"line":743},[147,1743,679],{"class":653},[147,1745,1498],{"class":682},[147,1747,667],{"class":653},[147,1749,670],{"class":653},[147,1751,1260],{"class":1259},[147,1753,699],{"class":653},[147,1755,1756,1758,1760,1762,1764,1767],{"class":149,"line":762},[147,1757,679],{"class":653},[147,1759,1516],{"class":682},[147,1761,667],{"class":653},[147,1763,670],{"class":653},[147,1765,1766],{"class":1259}," 10",[147,1768,699],{"class":653},[147,1770,1771,1773,1776,1778,1780,1783],{"class":149,"line":768},[147,1772,679],{"class":653},[147,1774,1775],{"class":682},"total",[147,1777,667],{"class":653},[147,1779,670],{"class":653},[147,1781,1782],{"class":1259}," 100",[147,1784,699],{"class":653},[147,1786,1787,1789,1792,1794,1796],{"class":149,"line":1317},[147,1788,679],{"class":653},[147,1790,1791],{"class":682},"items",[147,1793,667],{"class":653},[147,1795,670],{"class":653},[147,1797,1798],{"class":653}," [\n",[147,1800,1801],{"class":149,"line":1332},[147,1802,1803],{"class":653},"      {\n",[147,1805,1806,1809,1811,1813,1815,1817],{"class":149,"line":1337},[147,1807,1808],{"class":653},"        \"",[147,1810,1252],{"class":1259},[147,1812,667],{"class":653},[147,1814,670],{"class":653},[147,1816,1260],{"class":1259},[147,1818,699],{"class":653},[147,1820,1822,1824,1827,1829,1831,1834],{"class":149,"line":1821},12,[147,1823,1808],{"class":653},[147,1825,1826],{"class":1259},"created_at",[147,1828,667],{"class":653},[147,1830,670],{"class":653},[147,1832,1833],{"class":1259}," 1700000000",[147,1835,699],{"class":653},[147,1837,1839,1841,1843,1845,1847,1850],{"class":149,"line":1838},13,[147,1840,1808],{"class":653},[147,1842,707],{"class":1259},[147,1844,667],{"class":653},[147,1846,670],{"class":653},[147,1848,1849],{"class":1259}," 2",[147,1851,699],{"class":653},[147,1853,1855,1857,1860,1862,1864,1866,1869,1871],{"class":149,"line":1854},14,[147,1856,1808],{"class":653},[147,1858,1859],{"class":1259},"type_name",[147,1861,667],{"class":653},[147,1863,670],{"class":653},[147,1865,690],{"class":653},[147,1867,1868],{"class":693},"消费",[147,1870,667],{"class":653},[147,1872,699],{"class":653},[147,1874,1876,1878,1881,1883,1885,1887,1890,1892],{"class":149,"line":1875},15,[147,1877,1808],{"class":653},[147,1879,1880],{"class":1259},"content",[147,1882,667],{"class":653},[147,1884,670],{"class":653},[147,1886,690],{"class":653},[147,1888,1889],{"class":693},"模型推理",[147,1891,667],{"class":653},[147,1893,699],{"class":653},[147,1895,1897,1899,1902,1904,1906,1908,1911,1913],{"class":149,"line":1896},16,[147,1898,1808],{"class":653},[147,1900,1901],{"class":1259},"token_name",[147,1903,667],{"class":653},[147,1905,670],{"class":653},[147,1907,690],{"class":653},[147,1909,1910],{"class":693},"default",[147,1912,667],{"class":653},[147,1914,699],{"class":653},[147,1916,1918,1920,1922,1924,1926,1928,1931,1933],{"class":149,"line":1917},17,[147,1919,1808],{"class":653},[147,1921,1604],{"class":1259},[147,1923,667],{"class":653},[147,1925,670],{"class":653},[147,1927,690],{"class":653},[147,1929,1930],{"class":693},"gpt-3.5-turbo",[147,1932,667],{"class":653},[147,1934,699],{"class":653},[147,1936,1938,1940,1943,1945,1947,1949],{"class":149,"line":1937},18,[147,1939,1808],{"class":653},[147,1941,1942],{"class":1259},"app_name",[147,1944,667],{"class":653},[147,1946,670],{"class":653},[147,1948,1230],{"class":653},[147,1950,699],{"class":653},[147,1952,1954,1956,1959,1961,1963,1965,1967,1969],{"class":149,"line":1953},19,[147,1955,1808],{"class":653},[147,1957,1958],{"class":1259},"usage_name",[147,1960,667],{"class":653},[147,1962,670],{"class":653},[147,1964,690],{"class":653},[147,1966,1930],{"class":693},[147,1968,667],{"class":653},[147,1970,699],{"class":653},[147,1972,1974,1976,1979,1981,1983,1986],{"class":149,"line":1973},20,[147,1975,1808],{"class":653},[147,1977,1978],{"class":1259},"quota_usd",[147,1980,667],{"class":653},[147,1982,670],{"class":653},[147,1984,1985],{"class":1259}," 0.002",[147,1987,699],{"class":653},[147,1989,1991,1993,1995,1997,1999],{"class":149,"line":1990},21,[147,1992,1808],{"class":653},[147,1994,550],{"class":1259},[147,1996,667],{"class":653},[147,1998,670],{"class":653},[147,2000,2001],{"class":1259}," 2\n",[147,2003,2005],{"class":149,"line":2004},22,[147,2006,2007],{"class":653},"      }\n",[147,2009,2011],{"class":149,"line":2010},23,[147,2012,2013],{"class":653},"    ]\n",[147,2015,2017],{"class":149,"line":2016},24,[147,2018,765],{"class":653},[147,2020,2022],{"class":149,"line":2021},25,[147,2023,771],{"class":653},[1148,2025,1342],{"id":2026},"响应字段-1",[154,2028,2029,2039],{},[157,2030,2031],{},[160,2032,2033,2035,2037],{},[163,2034,347],{},[163,2036,350],{},[163,2038,168],{},[170,2040,2041,2051,2061,2079,2091,2103,2115,2128,2140,2152,2168,2182,2194,2205,2217,2229,2241,2253],{},[160,2042,2043,2047,2049],{},[175,2044,2045],{},[83,2046,992],{},[175,2048,1043],{},[175,2050,1367],{},[160,2052,2053,2057,2059],{},[175,2054,2055],{},[83,2056,683],{},[175,2058,795],{},[175,2060,1378],{},[160,2062,2063,2067,2069],{},[175,2064,2065],{},[83,2066,83],{},[175,2068,364],{},[175,2070,2071,2072,2074,2075,2078],{},"状态码，",[83,2073,1418],{}," 表示成功，",[83,2076,2077],{},"-1"," 表示业务失败",[160,2080,2081,2086,2088],{},[175,2082,2083],{},[83,2084,2085],{},"data.page",[175,2087,364],{},[175,2089,2090],{},"当前页码",[160,2092,2093,2098,2100],{},[175,2094,2095],{},[83,2096,2097],{},"data.page_size",[175,2099,364],{},[175,2101,2102],{},"每页条数",[160,2104,2105,2110,2112],{},[175,2106,2107],{},[83,2108,2109],{},"data.total",[175,2111,364],{},[175,2113,2114],{},"总记录数",[160,2116,2117,2122,2125],{},[175,2118,2119],{},[83,2120,2121],{},"data.items",[175,2123,2124],{},"array",[175,2126,2127],{},"消费记录列表",[160,2129,2130,2135,2137],{},[175,2131,2132],{},[83,2133,2134],{},"data.items[].id",[175,2136,364],{},[175,2138,2139],{},"日志 ID",[160,2141,2142,2147,2149],{},[175,2143,2144],{},[83,2145,2146],{},"data.items[].created_at",[175,2148,364],{},[175,2150,2151],{},"创建时间戳",[160,2153,2154,2159,2161],{},[175,2155,2156],{},[83,2157,2158],{},"data.items[].type",[175,2160,364],{},[175,2162,2163,2164,2167],{},"日志类型，固定为 ",[83,2165,2166],{},"2","（消费）",[160,2169,2170,2175,2177],{},[175,2171,2172],{},[83,2173,2174],{},"data.items[].type_name",[175,2176,795],{},[175,2178,2179,2180],{},"日志类型名称，固定为 ",[83,2181,1868],{},[160,2183,2184,2189,2191],{},[175,2185,2186],{},[83,2187,2188],{},"data.items[].content",[175,2190,795],{},[175,2192,2193],{},"日志内容",[160,2195,2196,2201,2203],{},[175,2197,2198],{},[83,2199,2200],{},"data.items[].token_name",[175,2202,795],{},[175,2204,1402],{},[160,2206,2207,2212,2214],{},[175,2208,2209],{},[83,2210,2211],{},"data.items[].model_name",[175,2213,795],{},[175,2215,2216],{},"模型名称",[160,2218,2219,2224,2226],{},[175,2220,2221],{},[83,2222,2223],{},"data.items[].app_name",[175,2225,795],{},[175,2227,2228],{},"应用名称（若来自 Apps 应用）",[160,2230,2231,2236,2238],{},[175,2232,2233],{},[83,2234,2235],{},"data.items[].usage_name",[175,2237,795],{},[175,2239,2240],{},"使用模型名称，或 Apps 应用名称",[160,2242,2243,2248,2250],{},[175,2244,2245],{},[83,2246,2247],{},"data.items[].quota_usd",[175,2249,1412],{},[175,2251,2252],{},"消费配额（⚡）",[160,2254,2255,2260,2262],{},[175,2256,2257],{},[83,2258,2259],{},"data.items[].quota_type",[175,2261,364],{},[175,2263,2264,2265,2267,2268,2270,2271,2273],{},"额度变动类型（",[83,2266,1418],{}," 无变动、",[83,2269,1509],{}," 增加、",[83,2272,2166],{}," 减少）",[103,2275],{},[106,2277,2278],{"id":2278},"相关文档",[308,2280,2281,2287,2292,2297],{},[311,2282,2283],{},[2284,2285,15],"a",{"href":2286},"../start/quick-start",[311,2288,2289],{},[2284,2290,19],{"href":2291},"../start/guide",[311,2293,2294],{},[2284,2295,23],{"href":2296},"../start/glossary",[311,2298,2299,2303,2304,2303,2308,2303,2312,2303,2316],{},[2284,2300,2302],{"href":2301},"./models","模型"," · ",[2284,2305,2307],{"href":2306},"./text","文本",[2284,2309,2311],{"href":2310},"./images","图像",[2284,2313,2315],{"href":2314},"./videos","视频",[2284,2317,2319],{"href":2318},"./audio","音频",[2321,2322,2323],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":123,"searchDepth":657,"depth":657,"links":2325},[2326,2332,2338,2343,2349],{"id":108,"depth":657,"text":108,"children":2327},[2328,2329,2330,2331],{"id":112,"depth":676,"text":113},{"id":132,"depth":676,"text":132},{"id":239,"depth":676,"text":240},{"id":306,"depth":676,"text":306},{"id":328,"depth":657,"text":328,"children":2333},[2334,2336],{"id":331,"depth":676,"text":2335},"usage（Token 计费）",{"id":526,"depth":676,"text":2337},"usage（按次计费，图像）",{"id":617,"depth":657,"text":617,"children":2339},[2340,2341,2342],{"id":620,"depth":676,"text":621},{"id":859,"depth":676,"text":860},{"id":967,"depth":676,"text":968},{"id":1065,"depth":657,"text":1065,"children":2344},[2345,2347],{"id":1134,"depth":676,"text":2346},"GET /v1/token/balance",{"id":1447,"depth":676,"text":2348},"GET /v1/token/consume",{"id":2278,"depth":657,"text":2278},"V1 开放 API 的鉴权、计费、公共对象与错误响应格式","md",{},true,{"title":33,"description":2350},"10Axod-wiyipowF1RXnWwFMB3lj81rOPVTx3PF0j77o",[2357,2359],{"title":23,"path":24,"stem":25,"description":2358,"children":-1},"帮助文档中常见概念、字段与错误术语说明",{"title":37,"path":38,"stem":39,"description":2360,"children":-1},"查询 API Key 可见的模型列表及各模型支持的端点类型",1787808399276]