[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-zh":3,"docs-zh-usage-and-balance\u002Fusage":144,"$fSRN_mKjqqQsF02yS_C6c1S2dq-mVBwql42EWzRJe6Bg":1043},[4,52,69,119,136,140],{"title":5,"path":6,"stem":7,"children":8,"page":-1},"快速开始","\u002Fgetting-started","1.getting-started",[9,12,30,44,48],{"title":10,"path":6,"stem":11},"关于 SilvaMux","1.getting-started\u002Findex",{"title":13,"path":14,"stem":15,"children":16,"page":-1},"首次调用千木 API","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F1.quick-start\u002Findex",[17,18,22,26],{"title":13,"path":14,"stem":15},{"title":19,"path":20,"stem":21},"项目和账户设置","\u002Fgetting-started\u002Fquick-start\u002Fproject-and-account","1.getting-started\u002F1.quick-start\u002F2.project-and-account",{"title":23,"path":24,"stem":25},"获取 API Key","\u002Fgetting-started\u002Fquick-start\u002Fapi-key","1.getting-started\u002F1.quick-start\u002F3.api-key",{"title":27,"path":28,"stem":29},"第一个请求","\u002Fgetting-started\u002Fquick-start\u002Ffirst-request","1.getting-started\u002F1.quick-start\u002F4.first-request",{"title":31,"path":32,"stem":33,"children":34,"page":43},"模型与体验","\u002Fgetting-started\u002Fmodels-and-experience","1.getting-started\u002F2.models-and-experience",[35,39],{"title":36,"path":37,"stem":38},"模型选择","\u002Fgetting-started\u002Fmodels-and-experience\u002Fmodel-selection","1.getting-started\u002F2.models-and-experience\u002F1.model-selection",{"title":40,"path":41,"stem":42},"在线体验","\u002Fgetting-started\u002Fmodels-and-experience\u002Fplayground","1.getting-started\u002F2.models-and-experience\u002F2.playground",false,{"title":45,"path":46,"stem":47},"限流","\u002Fgetting-started\u002Frate-limits","1.getting-started\u002F3.rate-limits",{"title":49,"path":50,"stem":51},"常见问题","\u002Fgetting-started\u002Ffaq","1.getting-started\u002F4.faq",{"title":53,"path":54,"stem":55,"children":56,"page":43},"产品计费","\u002Fbilling","2.billing",[57,61,65],{"title":58,"path":59,"stem":60},"计费说明","\u002Fbilling\u002Foverview","2.billing\u002F1.overview",{"title":62,"path":63,"stem":64},"在线充值","\u002Fbilling\u002Frecharge","2.billing\u002F2.recharge",{"title":66,"path":67,"stem":68},"账单、用量与导出","\u002Fbilling\u002Fusage-export","2.billing\u002F3.usage-export",{"title":70,"path":71,"stem":72,"children":73,"page":43},"模型接口","\u002Fmodels","4.models",[74,107],{"title":75,"path":76,"stem":77,"children":78,"page":43},"文本生成","\u002Fmodels\u002Fchat","4.models\u002F1.chat",[79,83,87,91,95,99,103],{"title":80,"path":81,"stem":82},"概述","\u002Fmodels\u002Fchat\u002Foverview","4.models\u002F1.chat\u002F1.overview",{"title":84,"path":85,"stem":86},"OpenAI 兼容接口","\u002Fmodels\u002Fchat\u002Fopenai","4.models\u002F1.chat\u002F2.openai",{"title":88,"path":89,"stem":90},"Anthropic 兼容","\u002Fmodels\u002Fchat\u002Fanthropic","4.models\u002F1.chat\u002F3.anthropic",{"title":92,"path":93,"stem":94},"Volcengine 兼容","\u002Fmodels\u002Fchat\u002Fvolcengine","4.models\u002F1.chat\u002F4.volcengine",{"title":96,"path":97,"stem":98},"智谱兼容","\u002Fmodels\u002Fchat\u002Fzhipu","4.models\u002F1.chat\u002F5.zhipu",{"title":100,"path":101,"stem":102},"SilvaMux 统一入口","\u002Fmodels\u002Fchat\u002Funified","4.models\u002F1.chat\u002F6.unified",{"title":104,"path":105,"stem":106},"多模态输入","\u002Fmodels\u002Fchat\u002Fmultimodal","4.models\u002F1.chat\u002F7.multimodal",{"title":108,"path":109,"stem":110,"children":111,"page":43},"图片生成","\u002Fmodels\u002Fimages","4.models\u002F2.images",[112,115],{"title":80,"path":113,"stem":114},"\u002Fmodels\u002Fimages\u002Foverview","4.models\u002F2.images\u002F1.overview",{"title":116,"path":117,"stem":118},"图片生成接口","\u002Fmodels\u002Fimages\u002Fgeneration","4.models\u002F2.images\u002F2.generation",{"title":120,"path":121,"stem":122,"children":123,"page":43},"用量与余额","\u002Fusage-and-balance","5.usage-and-balance",[124,128,132],{"title":125,"path":126,"stem":127},"查询余额","\u002Fusage-and-balance\u002Fbalance","5.usage-and-balance\u002F1.balance",{"title":129,"path":130,"stem":131},"查询用量","\u002Fusage-and-balance\u002Fusage","5.usage-and-balance\u002F2.usage",{"title":133,"path":134,"stem":135},"查询单次请求消耗","\u002Fusage-and-balance\u002Frequest-usage","5.usage-and-balance\u002F3.request-usage",{"title":137,"path":138,"stem":139},"错误码参考","\u002Ferrors","6.errors",{"title":141,"path":142,"stem":143},"文档首页","\u002F","index",{"id":145,"title":129,"body":146,"description":1036,"extension":1037,"meta":1038,"navigation":294,"path":130,"rawbody":1039,"requiredFlags":1040,"seo":1041,"stem":131,"__hash__":1042},"docs\u002F5.usage-and-balance\u002F2.usage.md",{"type":147,"value":148,"toc":1028},"minimark",[149,152,156,160,163,174,177,182,186,213,216,589,592,894,948,951,1024],[150,151,129],"h1",{"id":129},[153,154,155],"p",{},"返回指定时间段内、该 API Key 所属项目的消耗汇总：总额与按模型分项。消耗数据自动限定到 Key 所属的项目，不能跨项目查询。",[157,158,159],"h2",{"id":159},"鉴权",[153,161,162],{},"在请求头携带 API Key：",[164,165,170],"pre",{"className":166,"code":168,"language":169},[167],"language-text","Authorization: Bearer sk_live_YOUR_API_KEY\n","text",[171,172,168],"code",{"__ignoreMap":173},"",[157,175,176],{"id":176},"接口",[178,179],"api-endpoint",{"method":180,"path":181},"GET","\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage",[183,184,185],"h3",{"id":185},"参数",[187,188,189,210],"ul",{},[190,191,192,195,196,199,200,203,204,206,207,209],"li",{},[171,193,194],{},"from","、",[171,197,198],{},"to","：必填，RFC3339 时间，左闭右开 ",[171,201,202],{},"[from, to)","，",[171,205,194],{}," 必须早于 ",[171,208,198],{},"。",[190,211,212],{},"时间范围以 UTC 为准。",[183,214,215],{"id":215},"示例",[217,218,219,263,356,434],"code-tabs",{},[220,221,223],"code-tab",{"label":222},"cURL",[164,224,228],{"className":225,"code":226,"language":227,"meta":173,"style":173},"language-bash shiki shiki-themes github-light github-dark","curl \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage?from=2026-07-08T00:00:00Z&to=2026-07-09T00:00:00Z\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n","bash",[171,229,230,247],{"__ignoreMap":173},[231,232,235,239,243],"span",{"class":233,"line":234},"line",1,[231,236,238],{"class":237},"sScJk","curl",[231,240,242],{"class":241},"sZZnC"," \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage?from=2026-07-08T00:00:00Z&to=2026-07-09T00:00:00Z\"",[231,244,246],{"class":245},"sj4cs"," \\\n",[231,248,250,253,256,260],{"class":233,"line":249},2,[231,251,252],{"class":245},"  -H",[231,254,255],{"class":241}," \"Authorization: Bearer ",[231,257,259],{"class":258},"sVt8B","$SILVAMUX_API_KEY",[231,261,262],{"class":241},"\"\n",[220,264,266],{"label":265},"Python",[164,267,271],{"className":268,"code":269,"language":270,"meta":173,"style":173},"language-python shiki shiki-themes github-light github-dark","# pip install requests\nimport os\nimport requests\n\nresp = requests.get(\n    \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage\",\n    params={\n        \"from\": \"2026-07-08T00:00:00Z\",\n        \"to\": \"2026-07-09T00:00:00Z\",\n    },\n    headers={\"Authorization\": f\"Bearer {os.environ['SILVAMUX_API_KEY']}\"},\n)\nresp.raise_for_status()\nprint(resp.json()[\"totals\"])\n","python",[171,272,273,278,283,289,296,302,308,314,320,326,332,338,344,350],{"__ignoreMap":173},[231,274,275],{"class":233,"line":234},[231,276,277],{},"# pip install requests\n",[231,279,280],{"class":233,"line":249},[231,281,282],{},"import os\n",[231,284,286],{"class":233,"line":285},3,[231,287,288],{},"import requests\n",[231,290,292],{"class":233,"line":291},4,[231,293,295],{"emptyLinePlaceholder":294},true,"\n",[231,297,299],{"class":233,"line":298},5,[231,300,301],{},"resp = requests.get(\n",[231,303,305],{"class":233,"line":304},6,[231,306,307],{},"    \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage\",\n",[231,309,311],{"class":233,"line":310},7,[231,312,313],{},"    params={\n",[231,315,317],{"class":233,"line":316},8,[231,318,319],{},"        \"from\": \"2026-07-08T00:00:00Z\",\n",[231,321,323],{"class":233,"line":322},9,[231,324,325],{},"        \"to\": \"2026-07-09T00:00:00Z\",\n",[231,327,329],{"class":233,"line":328},10,[231,330,331],{},"    },\n",[231,333,335],{"class":233,"line":334},11,[231,336,337],{},"    headers={\"Authorization\": f\"Bearer {os.environ['SILVAMUX_API_KEY']}\"},\n",[231,339,341],{"class":233,"line":340},12,[231,342,343],{},")\n",[231,345,347],{"class":233,"line":346},13,[231,348,349],{},"resp.raise_for_status()\n",[231,351,353],{"class":233,"line":352},14,[231,354,355],{},"print(resp.json()[\"totals\"])\n",[220,357,359],{"label":358},"JavaScript",[164,360,364],{"className":361,"code":362,"language":363,"meta":173,"style":173},"language-javascript shiki shiki-themes github-light github-dark","\u002F\u002F Node 18+（内置 fetch）\nconst from = \"2026-07-08T00:00:00Z\";\nconst to = \"2026-07-09T00:00:00Z\";\nconst query = new URLSearchParams({ from, to });\n\nconst resp = await fetch(\n  `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage?${query}`,\n  {\n    headers: { Authorization: `Bearer ${process.env.SILVAMUX_API_KEY}` },\n  },\n);\n\nconst data = await resp.json();\nconsole.log(data.totals);\n","javascript",[171,365,366,371,376,381,386,390,395,400,405,410,415,420,424,429],{"__ignoreMap":173},[231,367,368],{"class":233,"line":234},[231,369,370],{},"\u002F\u002F Node 18+（内置 fetch）\n",[231,372,373],{"class":233,"line":249},[231,374,375],{},"const from = \"2026-07-08T00:00:00Z\";\n",[231,377,378],{"class":233,"line":285},[231,379,380],{},"const to = \"2026-07-09T00:00:00Z\";\n",[231,382,383],{"class":233,"line":291},[231,384,385],{},"const query = new URLSearchParams({ from, to });\n",[231,387,388],{"class":233,"line":298},[231,389,295],{"emptyLinePlaceholder":294},[231,391,392],{"class":233,"line":304},[231,393,394],{},"const resp = await fetch(\n",[231,396,397],{"class":233,"line":310},[231,398,399],{},"  `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage?${query}`,\n",[231,401,402],{"class":233,"line":316},[231,403,404],{},"  {\n",[231,406,407],{"class":233,"line":322},[231,408,409],{},"    headers: { Authorization: `Bearer ${process.env.SILVAMUX_API_KEY}` },\n",[231,411,412],{"class":233,"line":328},[231,413,414],{},"  },\n",[231,416,417],{"class":233,"line":334},[231,418,419],{},");\n",[231,421,422],{"class":233,"line":340},[231,423,295],{"emptyLinePlaceholder":294},[231,425,426],{"class":233,"line":346},[231,427,428],{},"const data = await resp.json();\n",[231,430,431],{"class":233,"line":352},[231,432,433],{},"console.log(data.totals);\n",[220,435,437],{"label":436},"Go",[164,438,442],{"className":439,"code":440,"language":441,"meta":173,"style":173},"language-go shiki shiki-themes github-light github-dark","\u002F\u002F 仅依赖标准库\npackage main\n\nimport (\n    \"fmt\"\n    \"io\"\n    \"net\u002Fhttp\"\n    \"os\"\n)\n\nfunc main() {\n    url := \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage?from=2026-07-08T00:00:00Z&to=2026-07-09T00:00:00Z\"\n\n    req, err := http.NewRequest(\"GET\", url, nil)\n    if err != nil {\n        panic(err)\n    }\n    req.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"SILVAMUX_API_KEY\"))\n\n    resp, err := http.DefaultClient.Do(req)\n    if err != nil {\n        panic(err)\n    }\n    defer resp.Body.Close()\n\n    body, _ := io.ReadAll(resp.Body)\n    fmt.Println(string(body))\n}\n","go",[171,443,444,449,454,458,463,468,473,478,483,487,491,496,501,505,510,516,522,528,534,539,545,550,555,560,566,571,577,583],{"__ignoreMap":173},[231,445,446],{"class":233,"line":234},[231,447,448],{},"\u002F\u002F 仅依赖标准库\n",[231,450,451],{"class":233,"line":249},[231,452,453],{},"package main\n",[231,455,456],{"class":233,"line":285},[231,457,295],{"emptyLinePlaceholder":294},[231,459,460],{"class":233,"line":291},[231,461,462],{},"import (\n",[231,464,465],{"class":233,"line":298},[231,466,467],{},"    \"fmt\"\n",[231,469,470],{"class":233,"line":304},[231,471,472],{},"    \"io\"\n",[231,474,475],{"class":233,"line":310},[231,476,477],{},"    \"net\u002Fhttp\"\n",[231,479,480],{"class":233,"line":316},[231,481,482],{},"    \"os\"\n",[231,484,485],{"class":233,"line":322},[231,486,343],{},[231,488,489],{"class":233,"line":328},[231,490,295],{"emptyLinePlaceholder":294},[231,492,493],{"class":233,"line":334},[231,494,495],{},"func main() {\n",[231,497,498],{"class":233,"line":340},[231,499,500],{},"    url := \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage?from=2026-07-08T00:00:00Z&to=2026-07-09T00:00:00Z\"\n",[231,502,503],{"class":233,"line":346},[231,504,295],{"emptyLinePlaceholder":294},[231,506,507],{"class":233,"line":352},[231,508,509],{},"    req, err := http.NewRequest(\"GET\", url, nil)\n",[231,511,513],{"class":233,"line":512},15,[231,514,515],{},"    if err != nil {\n",[231,517,519],{"class":233,"line":518},16,[231,520,521],{},"        panic(err)\n",[231,523,525],{"class":233,"line":524},17,[231,526,527],{},"    }\n",[231,529,531],{"class":233,"line":530},18,[231,532,533],{},"    req.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"SILVAMUX_API_KEY\"))\n",[231,535,537],{"class":233,"line":536},19,[231,538,295],{"emptyLinePlaceholder":294},[231,540,542],{"class":233,"line":541},20,[231,543,544],{},"    resp, err := http.DefaultClient.Do(req)\n",[231,546,548],{"class":233,"line":547},21,[231,549,515],{},[231,551,553],{"class":233,"line":552},22,[231,554,521],{},[231,556,558],{"class":233,"line":557},23,[231,559,527],{},[231,561,563],{"class":233,"line":562},24,[231,564,565],{},"    defer resp.Body.Close()\n",[231,567,569],{"class":233,"line":568},25,[231,570,295],{"emptyLinePlaceholder":294},[231,572,574],{"class":233,"line":573},26,[231,575,576],{},"    body, _ := io.ReadAll(resp.Body)\n",[231,578,580],{"class":233,"line":579},27,[231,581,582],{},"    fmt.Println(string(body))\n",[231,584,586],{"class":233,"line":585},28,[231,587,588],{},"}\n",[153,590,591],{},"响应：",[164,593,597],{"className":594,"code":595,"language":596,"meta":173,"style":173},"language-json shiki shiki-themes github-light github-dark","{\n  \"from\": \"2026-07-08T00:00:00Z\",\n  \"to\": \"2026-07-09T00:00:00Z\",\n  \"project_id\": \"PROJ-1\",\n  \"totals\": {\n    \"cost_points\": \"1.5\",\n    \"prompt_tokens\": 100,\n    \"cached_tokens\": 0,\n    \"billable_prompt_tokens\": 100,\n    \"completion_tokens\": 50,\n    \"cache_creation_tokens\": 0,\n    \"total_tokens\": 150,\n    \"generated_artifacts\": 0,\n    \"request_count\": 2\n  },\n  \"by_model\": [\n    {\n      \"model\": \"deepseek-v4-pro@tune\",\n      \"cost_points\": \"1.5\",\n      \"prompt_tokens\": 100,\n      \"cached_tokens\": 0,\n      \"billable_prompt_tokens\": 100,\n      \"completion_tokens\": 50,\n      \"cache_creation_tokens\": 0,\n      \"total_tokens\": 150,\n      \"generated_artifacts\": 0,\n      \"request_count\": 2\n    }\n  ]\n}\n","json",[171,598,599,604,618,630,642,650,662,674,686,697,709,720,732,743,753,757,765,770,782,793,804,815,826,837,848,859,870,879,883,889],{"__ignoreMap":173},[231,600,601],{"class":233,"line":234},[231,602,603],{"class":258},"{\n",[231,605,606,609,612,615],{"class":233,"line":249},[231,607,608],{"class":245},"  \"from\"",[231,610,611],{"class":258},": ",[231,613,614],{"class":241},"\"2026-07-08T00:00:00Z\"",[231,616,617],{"class":258},",\n",[231,619,620,623,625,628],{"class":233,"line":285},[231,621,622],{"class":245},"  \"to\"",[231,624,611],{"class":258},[231,626,627],{"class":241},"\"2026-07-09T00:00:00Z\"",[231,629,617],{"class":258},[231,631,632,635,637,640],{"class":233,"line":291},[231,633,634],{"class":245},"  \"project_id\"",[231,636,611],{"class":258},[231,638,639],{"class":241},"\"PROJ-1\"",[231,641,617],{"class":258},[231,643,644,647],{"class":233,"line":298},[231,645,646],{"class":245},"  \"totals\"",[231,648,649],{"class":258},": {\n",[231,651,652,655,657,660],{"class":233,"line":304},[231,653,654],{"class":245},"    \"cost_points\"",[231,656,611],{"class":258},[231,658,659],{"class":241},"\"1.5\"",[231,661,617],{"class":258},[231,663,664,667,669,672],{"class":233,"line":310},[231,665,666],{"class":245},"    \"prompt_tokens\"",[231,668,611],{"class":258},[231,670,671],{"class":245},"100",[231,673,617],{"class":258},[231,675,676,679,681,684],{"class":233,"line":316},[231,677,678],{"class":245},"    \"cached_tokens\"",[231,680,611],{"class":258},[231,682,683],{"class":245},"0",[231,685,617],{"class":258},[231,687,688,691,693,695],{"class":233,"line":322},[231,689,690],{"class":245},"    \"billable_prompt_tokens\"",[231,692,611],{"class":258},[231,694,671],{"class":245},[231,696,617],{"class":258},[231,698,699,702,704,707],{"class":233,"line":328},[231,700,701],{"class":245},"    \"completion_tokens\"",[231,703,611],{"class":258},[231,705,706],{"class":245},"50",[231,708,617],{"class":258},[231,710,711,714,716,718],{"class":233,"line":334},[231,712,713],{"class":245},"    \"cache_creation_tokens\"",[231,715,611],{"class":258},[231,717,683],{"class":245},[231,719,617],{"class":258},[231,721,722,725,727,730],{"class":233,"line":340},[231,723,724],{"class":245},"    \"total_tokens\"",[231,726,611],{"class":258},[231,728,729],{"class":245},"150",[231,731,617],{"class":258},[231,733,734,737,739,741],{"class":233,"line":346},[231,735,736],{"class":245},"    \"generated_artifacts\"",[231,738,611],{"class":258},[231,740,683],{"class":245},[231,742,617],{"class":258},[231,744,745,748,750],{"class":233,"line":352},[231,746,747],{"class":245},"    \"request_count\"",[231,749,611],{"class":258},[231,751,752],{"class":245},"2\n",[231,754,755],{"class":233,"line":512},[231,756,414],{"class":258},[231,758,759,762],{"class":233,"line":518},[231,760,761],{"class":245},"  \"by_model\"",[231,763,764],{"class":258},": [\n",[231,766,767],{"class":233,"line":524},[231,768,769],{"class":258},"    {\n",[231,771,772,775,777,780],{"class":233,"line":530},[231,773,774],{"class":245},"      \"model\"",[231,776,611],{"class":258},[231,778,779],{"class":241},"\"deepseek-v4-pro@tune\"",[231,781,617],{"class":258},[231,783,784,787,789,791],{"class":233,"line":536},[231,785,786],{"class":245},"      \"cost_points\"",[231,788,611],{"class":258},[231,790,659],{"class":241},[231,792,617],{"class":258},[231,794,795,798,800,802],{"class":233,"line":541},[231,796,797],{"class":245},"      \"prompt_tokens\"",[231,799,611],{"class":258},[231,801,671],{"class":245},[231,803,617],{"class":258},[231,805,806,809,811,813],{"class":233,"line":547},[231,807,808],{"class":245},"      \"cached_tokens\"",[231,810,611],{"class":258},[231,812,683],{"class":245},[231,814,617],{"class":258},[231,816,817,820,822,824],{"class":233,"line":552},[231,818,819],{"class":245},"      \"billable_prompt_tokens\"",[231,821,611],{"class":258},[231,823,671],{"class":245},[231,825,617],{"class":258},[231,827,828,831,833,835],{"class":233,"line":557},[231,829,830],{"class":245},"      \"completion_tokens\"",[231,832,611],{"class":258},[231,834,706],{"class":245},[231,836,617],{"class":258},[231,838,839,842,844,846],{"class":233,"line":562},[231,840,841],{"class":245},"      \"cache_creation_tokens\"",[231,843,611],{"class":258},[231,845,683],{"class":245},[231,847,617],{"class":258},[231,849,850,853,855,857],{"class":233,"line":568},[231,851,852],{"class":245},"      \"total_tokens\"",[231,854,611],{"class":258},[231,856,729],{"class":245},[231,858,617],{"class":258},[231,860,861,864,866,868],{"class":233,"line":573},[231,862,863],{"class":245},"      \"generated_artifacts\"",[231,865,611],{"class":258},[231,867,683],{"class":245},[231,869,617],{"class":258},[231,871,872,875,877],{"class":233,"line":579},[231,873,874],{"class":245},"      \"request_count\"",[231,876,611],{"class":258},[231,878,752],{"class":245},[231,880,881],{"class":233,"line":585},[231,882,527],{"class":258},[231,884,886],{"class":233,"line":885},29,[231,887,888],{"class":258},"  ]\n",[231,890,892],{"class":233,"line":891},30,[231,893,588],{"class":258},[895,896,897,910],"table",{},[898,899,900],"thead",{},[901,902,903,907],"tr",{},[904,905,906],"th",{},"字段",[904,908,909],{},"说明",[911,912,913,924,934],"tbody",{},[901,914,915,921],{},[916,917,918],"td",{},[171,919,920],{},"project_id",[916,922,923],{},"该 API Key 绑定的项目",[901,925,926,931],{},[916,927,928],{},[171,929,930],{},"totals",[916,932,933],{},"时间范围内所有模型的汇总",[901,935,936,941],{},[916,937,938],{},[171,939,940],{},"by_model",[916,942,943,944,947],{},"按模型分项，按 ",[171,945,946],{},"cost_points"," 降序",[157,949,950],{"id":950},"错误处理",[895,952,953,965],{},[898,954,955],{},[901,956,957,960,963],{},[904,958,959],{},"HTTP 状态",[904,961,962],{},"错误码",[904,964,909],{},[911,966,967,980,995,1008],{},[901,968,969,972,977],{},[916,970,971],{},"401",[916,973,974],{},[171,975,976],{},"INVALID_TOKEN",[916,978,979],{},"API Key 缺失或无效",[901,981,982,985,990],{},[916,983,984],{},"400",[916,986,987],{},[171,988,989],{},"INVALID_FROM_DATETIME",[916,991,992,994],{},[171,993,194],{}," 缺失或格式非 RFC3339",[901,996,997,999,1004],{},[916,998,984],{},[916,1000,1001],{},[171,1002,1003],{},"INVALID_TO_DATETIME",[916,1005,1006,994],{},[171,1007,198],{},[901,1009,1010,1012,1017],{},[916,1011,984],{},[916,1013,1014],{},[171,1015,1016],{},"INVALID_TIME_RANGE",[916,1018,1019,1021,1022],{},[171,1020,194],{}," 不早于 ",[171,1023,198],{},[1025,1026,1027],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}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);}",{"title":173,"searchDepth":249,"depth":249,"links":1029},[1030,1031,1035],{"id":159,"depth":249,"text":159},{"id":176,"depth":249,"text":176,"children":1032},[1033,1034],{"id":185,"depth":285,"text":185},{"id":215,"depth":285,"text":215},{"id":950,"depth":249,"text":950},"使用 API Key 查询项目在时间范围内的消耗汇总。","md",{},"---\ntitle: 查询用量\ndescription: 使用 API Key 查询项目在时间范围内的消耗汇总。\n---\n\n# 查询用量\n\n返回指定时间段内、该 API Key 所属项目的消耗汇总：总额与按模型分项。消耗数据自动限定到 Key 所属的项目，不能跨项目查询。\n\n## 鉴权\n\n在请求头携带 API Key：\n\n```\nAuthorization: Bearer sk_live_YOUR_API_KEY\n```\n\n## 接口\n\n::api-endpoint{path=\"\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage\" method=\"GET\"}\n::\n\n### 参数\n\n- `from`、`to`：必填，RFC3339 时间，左闭右开 `[from, to)`，`from` 必须早于 `to`。\n- 时间范围以 UTC 为准。\n\n### 示例\n\n::code-tabs\n:::code-tab{label=\"cURL\"}\n```bash\ncurl \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage?from=2026-07-08T00:00:00Z&to=2026-07-09T00:00:00Z\" \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\"\n```\n:::\n:::code-tab{label=\"Python\"}\n```python\n# pip install requests\nimport os\nimport requests\n\nresp = requests.get(\n    \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage\",\n    params={\n        \"from\": \"2026-07-08T00:00:00Z\",\n        \"to\": \"2026-07-09T00:00:00Z\",\n    },\n    headers={\"Authorization\": f\"Bearer {os.environ['SILVAMUX_API_KEY']}\"},\n)\nresp.raise_for_status()\nprint(resp.json()[\"totals\"])\n```\n:::\n:::code-tab{label=\"JavaScript\"}\n```javascript\n\u002F\u002F Node 18+（内置 fetch）\nconst from = \"2026-07-08T00:00:00Z\";\nconst to = \"2026-07-09T00:00:00Z\";\nconst query = new URLSearchParams({ from, to });\n\nconst resp = await fetch(\n  `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage?${query}`,\n  {\n    headers: { Authorization: `Bearer ${process.env.SILVAMUX_API_KEY}` },\n  },\n);\n\nconst data = await resp.json();\nconsole.log(data.totals);\n```\n:::\n:::code-tab{label=\"Go\"}\n```go\n\u002F\u002F 仅依赖标准库\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net\u002Fhttp\"\n\t\"os\"\n)\n\nfunc main() {\n\turl := \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage?from=2026-07-08T00:00:00Z&to=2026-07-09T00:00:00Z\"\n\n\treq, err := http.NewRequest(\"GET\", url, nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"SILVAMUX_API_KEY\"))\n\n\tresp, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer resp.Body.Close()\n\n\tbody, _ := io.ReadAll(resp.Body)\n\tfmt.Println(string(body))\n}\n```\n:::\n::\n\n响应：\n\n```json\n{\n  \"from\": \"2026-07-08T00:00:00Z\",\n  \"to\": \"2026-07-09T00:00:00Z\",\n  \"project_id\": \"PROJ-1\",\n  \"totals\": {\n    \"cost_points\": \"1.5\",\n    \"prompt_tokens\": 100,\n    \"cached_tokens\": 0,\n    \"billable_prompt_tokens\": 100,\n    \"completion_tokens\": 50,\n    \"cache_creation_tokens\": 0,\n    \"total_tokens\": 150,\n    \"generated_artifacts\": 0,\n    \"request_count\": 2\n  },\n  \"by_model\": [\n    {\n      \"model\": \"deepseek-v4-pro@tune\",\n      \"cost_points\": \"1.5\",\n      \"prompt_tokens\": 100,\n      \"cached_tokens\": 0,\n      \"billable_prompt_tokens\": 100,\n      \"completion_tokens\": 50,\n      \"cache_creation_tokens\": 0,\n      \"total_tokens\": 150,\n      \"generated_artifacts\": 0,\n      \"request_count\": 2\n    }\n  ]\n}\n```\n\n| 字段 | 说明 |\n|---|---|\n| `project_id` | 该 API Key 绑定的项目 |\n| `totals` | 时间范围内所有模型的汇总 |\n| `by_model` | 按模型分项，按 `cost_points` 降序 |\n\n## 错误处理\n\n| HTTP 状态 | 错误码 | 说明 |\n|---|---|---|\n| 401 | `INVALID_TOKEN` | API Key 缺失或无效 |\n| 400 | `INVALID_FROM_DATETIME` | `from` 缺失或格式非 RFC3339 |\n| 400 | `INVALID_TO_DATETIME` | `to` 缺失或格式非 RFC3339 |\n| 400 | `INVALID_TIME_RANGE` | `from` 不早于 `to` |\n",[],{"title":129,"description":1036},"Tg_3RcwTaepXBwIXQ3juUzgNskmOdLMSzUcxctl3xqE",{"found":294,"operationId":1044,"summary":129,"description":1045,"method":180,"path":181,"publiclyDiscoverable":294,"security":1046,"parameters":1049,"requestBody":1062,"responses":1066},"customer-usage","Return aggregated usage (totals + per-model) for the API key's project over a time range. API key only.",{"schemes":1047,"optional":43},[1048],"apikey",[1050,1054,1057,1060],{"name":1051,"type":1052,"required":294,"description":1053},"Authorization","string · header","Bearer API Key (sk_live_...)",{"name":1055,"type":1052,"required":43,"description":1056},"X-Organization-Id","Not required for API key auth",{"name":194,"type":1058,"required":294,"description":1059},"string · query","RFC3339 start time (inclusive)",{"name":198,"type":1058,"required":294,"description":1061},"RFC3339 end time (exclusive)",{"present":43,"required":43,"description":173,"contentType":173,"type":1063,"fields":1064,"variants":1065},"any",[],[],[1067,1149],{"status":1068,"description":1069,"contentType":1070,"type":1071,"fields":1072},"200","OK","application\u002Fjson","BillingUsageReportResponse",[1073,1077,1080,1084,1087,1090,1093,1096,1100,1103,1106,1109,1112,1115,1118,1121,1123,1125,1127,1129,1131,1133,1135,1137,1139,1141,1143,1145,1147],{"name":1074,"type":1075,"required":43,"description":1076},"$schema","string (uri)","A URL to the JSON Schema for this object.",{"name":940,"type":1078,"required":294,"description":1079},"array\u003CUsageReportModelBreakdown>","Per-model breakdown, ordered by cost_points desc",{"name":1081,"type":1082,"required":294,"description":1083},"by_model.billable_prompt_tokens","integer (int64)","Summed billable prompt tokens",{"name":1085,"type":1082,"required":294,"description":1086},"by_model.cache_creation_tokens","Summed cache creation tokens",{"name":1088,"type":1082,"required":294,"description":1089},"by_model.cache_explicit_read_tokens","Summed explicit cache read tokens",{"name":1091,"type":1082,"required":294,"description":1092},"by_model.cached_tokens","Summed cached tokens",{"name":1094,"type":1082,"required":294,"description":1095},"by_model.completion_tokens","Summed completion tokens",{"name":1097,"type":1098,"required":294,"description":1099},"by_model.cost_points","string","Total cost in points (after discount)",{"name":1101,"type":1082,"required":294,"description":1102},"by_model.generated_artifacts","Summed generated artifacts",{"name":1104,"type":1098,"required":294,"description":1105},"by_model.model","Aggregation key: user-supplied request_model, falling back to the configured model ID for legacy rows",{"name":1107,"type":1098,"required":294,"description":1108},"by_model.original_cost","Total cost in points before discount",{"name":1110,"type":1082,"required":294,"description":1111},"by_model.prompt_tokens","Summed prompt tokens",{"name":1113,"type":1082,"required":294,"description":1114},"by_model.request_count","Number of billed requests",{"name":1116,"type":1082,"required":294,"description":1117},"by_model.total_tokens","Summed total tokens",{"name":194,"type":1119,"required":294,"description":1120},"string (date-time)","Report start (RFC3339, inclusive)",{"name":920,"type":1098,"required":294,"description":1122},"Project filter ('' means org-wide)",{"name":198,"type":1119,"required":294,"description":1124},"Report end (RFC3339, exclusive)",{"name":930,"type":1126,"required":294,"description":173},"UsageReportTotals",{"name":1128,"type":1082,"required":294,"description":173},"totals.billable_prompt_tokens",{"name":1130,"type":1082,"required":294,"description":173},"totals.cache_creation_tokens",{"name":1132,"type":1082,"required":294,"description":173},"totals.cache_explicit_read_tokens",{"name":1134,"type":1082,"required":294,"description":173},"totals.cached_tokens",{"name":1136,"type":1082,"required":294,"description":173},"totals.completion_tokens",{"name":1138,"type":1098,"required":294,"description":1099},"totals.cost_points",{"name":1140,"type":1082,"required":294,"description":173},"totals.generated_artifacts",{"name":1142,"type":1098,"required":294,"description":1108},"totals.original_cost",{"name":1144,"type":1082,"required":294,"description":173},"totals.prompt_tokens",{"name":1146,"type":1082,"required":294,"description":173},"totals.request_count",{"name":1148,"type":1082,"required":294,"description":173},"totals.total_tokens",{"status":1150,"description":1151,"contentType":1152,"type":1153,"fields":1154},"default","Error","application\u002Fproblem+json","ErrorModel",[1155,1156,1159,1163,1166,1169,1172,1175,1178,1181],{"name":1074,"type":1075,"required":43,"description":1076},{"name":1157,"type":1098,"required":43,"description":1158},"detail","A human-readable explanation specific to this occurrence of the problem.",{"name":1160,"type":1161,"required":43,"description":1162},"errors","array\u003CErrorDetail>","Optional list of individual error details",{"name":1164,"type":1098,"required":43,"description":1165},"errors.location","Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'",{"name":1167,"type":1098,"required":43,"description":1168},"errors.message","Error message text",{"name":1170,"type":1063,"required":43,"description":1171},"errors.value","The value at the given location",{"name":1173,"type":1075,"required":43,"description":1174},"instance","A URI reference that identifies the specific occurrence of the problem.",{"name":1176,"type":1082,"required":43,"description":1177},"status","HTTP status code",{"name":1179,"type":1098,"required":43,"description":1180},"title","A short, human-readable summary of the problem type. This value should not change between occurrences of the error.",{"name":1182,"type":1075,"required":43,"description":1183,"defaultValue":1184},"type","A URI reference to human-readable documentation for the error.","about:blank"]