[{"data":1,"prerenderedAt":877},["ShallowReactive",2],{"doc-\u002Fdocs\u002Freference\u002Fcloud-api":3,"doc-surround-\u002Fdocs\u002Freference\u002Fcloud-api":780,"doc-nav-zh":786},{"id":4,"title":5,"body":6,"description":770,"extension":771,"meta":772,"navigation":773,"order":774,"path":775,"section":776,"seo":777,"stem":778,"__hash__":779},"docs_zh\u002Fdocs\u002F04.reference\u002F19.cloud-api.md","云端 REST API",{"type":7,"value":8,"toc":757},"minimark",[9,13,26,43,47,50,86,109,113,206,209,336,339,413,416,502,505,570,574,577,635,647,650,719,722,729,732,753],[10,11,5],"h1",{"id":12},"云端-rest-api",[14,15,16,17,21,22,25],"p",{},"灵犀指云端服务提供 REST API，供 IDE 内核、官网与第三方集成调用。所有端点以 ",[18,19,20],"code",{},"\u002Fapi\u002Fv1"," 为前缀，默认部署于官网域名（下文以 ",[18,23,24],{},"https:\u002F\u002Fwww.lingxizhiai.com"," 为例，实际地址以你的部署配置为准）。",[27,28,30],"callout",{"type":29},"tip",[14,31,32,36,37,42],{},[33,34,35],"strong",{},"面向谁","：本文面向需要与服务端直连的开发者（CI 集成、自建工具等）。日常使用 IDE 时无需关心这些端点——内核已内置全部调用。本地内核（3721 端口）的端点清单见",[38,39,41],"a",{"href":40},"\u002Fdocs\u002Freference\u002Fkernel-api","内核 API","。",[44,45,46],"h2",{"id":46},"认证",[14,48,49],{},"除标注「公开」的端点外，均需在请求头携带 JWT Bearer 令牌：",[51,52,57],"pre",{"className":53,"code":54,"language":55,"meta":56,"style":56},"language-bash shiki shiki-themes tokyo-night","curl -H \"Authorization: Bearer \u003Caccess_token>\" https:\u002F\u002Fwww.lingxizhiai.com\u002Fapi\u002Fv1\u002Fmembership\u002Fcurrent\n","bash","",[18,58,59],{"__ignoreMap":56},[60,61,64,68,72,76,80,83],"span",{"class":62,"line":63},"line",1,[60,65,67],{"class":66},"sE3pS","curl",[60,69,71],{"class":70},"sT800"," -H",[60,73,75],{"class":74},"sAklC"," \"",[60,77,79],{"class":78},"sPY7s","Authorization: Bearer \u003Caccess_token>",[60,81,82],{"class":74},"\"",[60,84,85],{"class":78}," https:\u002F\u002Fwww.lingxizhiai.com\u002Fapi\u002Fv1\u002Fmembership\u002Fcurrent\n",[14,87,88,89,92,93,96,97,100,101,104,105,108],{},"令牌通过 ",[18,90,91],{},"\u002Fauth\u002Flogin"," 获取，有效期结束前用 refresh token 调 ",[18,94,95],{},"\u002Fauth\u002Frefresh"," 续期。启用 MFA 的账户登录会返回 ",[18,98,99],{},"mfa_required"," + ",[18,102,103],{},"mfa_ticket","，需再调 ",[18,106,107],{},"\u002Fauth\u002Fmfa\u002Fverify"," 完成二步验证后才能取得令牌。",[110,111,112],"h3",{"id":112},"认证端点",[114,115,116,132],"table",{},[117,118,119],"thead",{},[120,121,122,126,129],"tr",{},[123,124,125],"th",{},"Method",[123,127,128],{},"Path",[123,130,131],{},"说明",[133,134,135,149,160,171,183,195],"tbody",{},[120,136,137,141,146],{},[138,139,140],"td",{},"POST",[138,142,143],{},[18,144,145],{},"\u002Fauth\u002Fregister",[138,147,148],{},"注册（邮箱 + 用户名 + 密码 + 验证码）",[120,150,151,153,157],{},[138,152,140],{},[138,154,155],{},[18,156,91],{},[138,158,159],{},"登录；MFA 账户返回中间态票据",[120,161,162,164,168],{},[138,163,140],{},[138,165,166],{},[18,167,107],{},[138,169,170],{},"MFA 二步验证（票据 + 动态码\u002F恢复码）",[120,172,173,175,180],{},[138,174,140],{},[138,176,177],{},[18,178,179],{},"\u002Fauth\u002Fsend-code",[138,181,182],{},"发送邮箱验证码（注册\u002F重置密码）",[120,184,185,187,192],{},[138,186,140],{},[138,188,189],{},[18,190,191],{},"\u002Fauth\u002Freset-password",[138,193,194],{},"重置密码",[120,196,197,199,203],{},[138,198,140],{},[138,200,201],{},[18,202,95],{},[138,204,205],{},"刷新 access token（公开，持 refresh token）",[44,207,208],{"id":208},"会员与订阅",[114,210,211,221],{},[117,212,213],{},[120,214,215,217,219],{},[123,216,125],{},[123,218,128],{},[123,220,131],{},[133,222,223,240,252,264,276,288,300,312,324],{},[120,224,225,228,233],{},[138,226,227],{},"GET",[138,229,230],{},[18,231,232],{},"\u002Fmembership\u002Fplans",[138,234,235,236,239],{},"套餐目录（",[33,237,238],{},"公开","，营销页动态定价来源）",[120,241,242,244,249],{},[138,243,227],{},[138,245,246],{},[18,247,248],{},"\u002Fmembership\u002Fcurrent",[138,250,251],{},"当前会员状态（含积分余额）",[120,253,254,256,261],{},[138,255,140],{},[138,257,258],{},[18,259,260],{},"\u002Fmembership\u002Fsubscribe",[138,262,263],{},"创建订阅订单（待支付）",[120,265,266,268,273],{},[138,267,140],{},[138,269,270],{},[18,271,272],{},"\u002Fmembership\u002Fupgrade",[138,274,275],{},"升级到更高档位（剩余积分全额结转）",[120,277,278,280,285],{},[138,279,140],{},[138,281,282],{},[18,283,284],{},"\u002Fmembership\u002Fcancel",[138,286,287],{},"取消订阅（周期结束后降为免费版）",[120,289,290,292,297],{},[138,291,227],{},[138,293,294],{},[18,295,296],{},"\u002Fmembership\u002Fquota",[138,298,299],{},"配额检查",[120,301,302,304,309],{},[138,303,227],{},[138,305,306],{},[18,307,308],{},"\u002Fmembership\u002Fusage?days=30",[138,310,311],{},"订阅用量（按日）",[120,313,314,316,321],{},[138,315,227],{},[138,317,318],{},[18,319,320],{},"\u002Fmembership\u002Forders",[138,322,323],{},"订单列表",[120,325,326,328,333],{},[138,327,140],{},[138,329,330],{},[18,331,332],{},"\u002Fmembership\u002Forders\u002F:order_no\u002Fcancel",[138,334,335],{},"取消自己的待支付订单",[44,337,338],{"id":338},"积分",[114,340,341,351],{},[117,342,343],{},[120,344,345,347,349],{},[123,346,125],{},[123,348,128],{},[123,350,131],{},[133,352,353,365,377,389,401],{},[120,354,355,357,362],{},[138,356,227],{},[138,358,359],{},[18,360,361],{},"\u002Fcredits\u002Fbalance",[138,363,364],{},"增购积分余额与套餐积分余量",[120,366,367,369,374],{},[138,368,227],{},[138,370,371],{},[18,372,373],{},"\u002Fcredits\u002Fledger?limit&offset",[138,375,376],{},"积分流水（充值\u002F扣减\u002F结转）",[120,378,379,381,386],{},[138,380,140],{},[138,382,383],{},[18,384,385],{},"\u002Fcredits\u002Frecharge",[138,387,388],{},"创建增购积分订单（微信\u002F支付宝）",[120,390,391,393,398],{},[138,392,227],{},[138,394,395],{},[18,396,397],{},"\u002Fcredits\u002Forders\u002F:order_no",[138,399,400],{},"积分订单状态",[120,402,403,405,410],{},[138,404,227],{},[138,406,407],{},[18,408,409],{},"\u002Fcredits\u002Forders",[138,411,412],{},"积分订单列表",[44,414,415],{"id":415},"用量统计",[114,417,418,428],{},[117,419,420],{},[120,421,422,424,426],{},[123,423,125],{},[123,425,128],{},[123,427,131],{},[133,429,430,442,454,466,478,490],{},[120,431,432,434,439],{},[138,433,227],{},[138,435,436],{},[18,437,438],{},"\u002Fusage\u002Flogs?limit&offset",[138,440,441],{},"调用日志明细",[120,443,444,446,451],{},[138,445,227],{},[138,447,448],{},[18,449,450],{},"\u002Fusage\u002Fstats?days=7",[138,452,453],{},"用量汇总（请求数、Token、缓存节省）",[120,455,456,458,463],{},[138,457,227],{},[138,459,460],{},[18,461,462],{},"\u002Fusage\u002Fdaily?days=30",[138,464,465],{},"按日用量",[120,467,468,470,475],{},[138,469,227],{},[138,471,472],{},[18,473,474],{},"\u002Fusage\u002Fmodels?days=30",[138,476,477],{},"按模型统计",[120,479,480,482,487],{},[138,481,227],{},[138,483,484],{},[18,485,486],{},"\u002Fusage\u002Fcost?days=30",[138,488,489],{},"费用统计",[120,491,492,494,499],{},[138,493,227],{},[138,495,496],{},[18,497,498],{},"\u002Fusage\u002Fcompletions",[138,500,501],{},"近 30 天补全采纳率",[44,503,504],{"id":504},"在线支付",[114,506,507,517],{},[117,508,509],{},[120,510,511,513,515],{},[123,512,125],{},[123,514,128],{},[123,516,131],{},[133,518,519,534,546,558],{},[120,520,521,523,528],{},[138,522,227],{},[138,524,525],{},[18,526,527],{},"\u002Fpayment\u002Fconfig",[138,529,530,531,533],{},"支付渠道开关（",[33,532,238],{},"）",[120,535,536,538,543],{},[138,537,140],{},[138,539,540],{},[18,541,542],{},"\u002Fpayment\u002Forders",[138,544,545],{},"创建支付订单（订阅或积分充值）",[120,547,548,550,555],{},[138,549,227],{},[138,551,552],{},[18,553,554],{},"\u002Fpayment\u002Forders\u002F:order_no",[138,556,557],{},"订单状态轮询",[120,559,560,562,567],{},[138,561,140],{},[138,563,564],{},[18,565,566],{},"\u002Fpayment\u002Fnotify\u002F:channel",[138,568,569],{},"渠道异步回调（平台间调用，验签在服务端）",[44,571,573],{"id":572},"llm-官方托管池网关openai-兼容","LLM 官方托管池网关（OpenAI 兼容）",[14,575,576],{},"官方托管池提供 OpenAI 兼容的对话接口——免 BYOK，按积分计费。使用用户 access token 作为 Bearer：",[51,578,580],{"className":53,"code":579,"language":55,"meta":56,"style":56},"curl https:\u002F\u002Fwww.lingxizhiai.com\u002Fapi\u002Fv1\u002Fllm\u002Fgateway\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Authorization: Bearer \u003Caccess_token>\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"model\": \"glm-5.2\", \"messages\": [{\"role\": \"user\", \"content\": \"你好\"}], \"stream\": true}'\n",[18,581,582,592,606,620],{"__ignoreMap":56},[60,583,584,586,589],{"class":62,"line":63},[60,585,67],{"class":66},[60,587,588],{"class":78}," https:\u002F\u002Fwww.lingxizhiai.com\u002Fapi\u002Fv1\u002Fllm\u002Fgateway\u002Fv1\u002Fchat\u002Fcompletions",[60,590,591],{"class":74}," \\\n",[60,593,595,598,600,602,604],{"class":62,"line":594},2,[60,596,597],{"class":70},"  -H",[60,599,75],{"class":74},[60,601,79],{"class":78},[60,603,82],{"class":74},[60,605,591],{"class":74},[60,607,609,611,613,616,618],{"class":62,"line":608},3,[60,610,597],{"class":70},[60,612,75],{"class":74},[60,614,615],{"class":78},"Content-Type: application\u002Fjson",[60,617,82],{"class":74},[60,619,591],{"class":74},[60,621,623,626,629,632],{"class":62,"line":622},4,[60,624,625],{"class":70},"  -d",[60,627,628],{"class":74}," '",[60,630,631],{"class":78},"{\"model\": \"glm-5.2\", \"messages\": [{\"role\": \"user\", \"content\": \"你好\"}], \"stream\": true}",[60,633,634],{"class":74},"'\n",[14,636,637,638,641,642,646],{},"支持 ",[18,639,640],{},"stream"," SSE 流式透传；扣费顺序为先套餐积分、后增购积分，积分不足时返回 402。模型清单与零售价由服务端统一管理，旗舰模型有最低套餐档位要求（见",[38,643,645],{"href":644},"\u002Fdocs\u002Fmodels-billing\u002Fplans-quota","套餐与积分","）。",[44,648,649],{"id":649},"云端任务与沙箱",[114,651,652,662],{},[117,653,654],{},[120,655,656,658,660],{},[123,657,125],{},[123,659,128],{},[123,661,131],{},[133,663,664,676,692,704],{},[120,665,666,668,673],{},[138,667,140],{},[138,669,670],{},[18,671,672],{},"\u002Ftasks\u002Fsubmit",[138,674,675],{},"提交云端任务",[120,677,678,680,689],{},[138,679,227],{},[138,681,682,685,686],{},[18,683,684],{},"\u002Ftasks"," · ",[18,687,688],{},"\u002Ftasks\u002F:id",[138,690,691],{},"任务列表 \u002F 状态",[120,693,694,696,701],{},[138,695,140],{},[138,697,698],{},[18,699,700],{},"\u002Ftasks\u002F:id\u002Fcancel",[138,702,703],{},"取消任务",[120,705,706,708,716],{},[138,707,227],{},[138,709,710,685,713],{},[18,711,712],{},"\u002Fcloud\u002Fvms",[18,714,715],{},"\u002Fcloud\u002Fquotas",[138,717,718],{},"云沙箱实例与配额",[44,720,721],{"id":721},"速率限制",[14,723,724,725,728],{},"登录、验证码、支付回调等敏感端点均有限流（登录类按小时计）。触发限流返回 ",[18,726,727],{},"429","，部分端点会要求图形验证码。集成时请实现指数退避重试，并避免高频轮询——订单状态建议 3-5 秒间隔轮询。",[44,730,731],{"id":731},"下一步",[733,734,735,741,746],"ul",{},[736,737,738,739,42],"li",{},"本地内核端点（3721 端口）速查表：",[38,740,41],{"href":40},[736,742,743,744,42],{},"套餐档位与模型门控：",[38,745,645],{"href":644},[736,747,748,749,42],{},"自备厂商 Key 直连：",[38,750,752],{"href":751},"\u002Fdocs\u002Fmodels-billing\u002Fbyok","自带 API Key",[754,755,756],"style",{},"html pre.shiki code .sE3pS, html code.shiki .sE3pS{--shiki-default:#C0CAF5}html pre.shiki code .sT800, html code.shiki .sT800{--shiki-default:#E0AF68}html pre.shiki code .sAklC, html code.shiki .sAklC{--shiki-default:#89DDFF}html pre.shiki code .sPY7s, html code.shiki .sPY7s{--shiki-default:#9ECE6A}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);}",{"title":56,"searchDepth":594,"depth":594,"links":758},[759,762,763,764,765,766,767,768,769],{"id":46,"depth":594,"text":46,"children":760},[761],{"id":112,"depth":608,"text":112},{"id":208,"depth":594,"text":208},{"id":338,"depth":594,"text":338},{"id":415,"depth":594,"text":415},{"id":504,"depth":594,"text":504},{"id":572,"depth":594,"text":573},{"id":649,"depth":594,"text":649},{"id":721,"depth":594,"text":721},{"id":731,"depth":594,"text":731},"灵犀指云端服务 REST API 概览：认证方式、会员与积分、用量统计、在线支付、LLM 网关（OpenAI 兼容）与云端任务端点速查","md",{},true,19,"\u002Fdocs\u002Freference\u002Fcloud-api","参考与 FAQ",{"title":5,"description":770},"docs\u002F04.reference\u002F19.cloud-api","dLxtGVEgmEPs-Rte2St1e_mpemolxo2HyWyCU7TQwCE",[781,785],{"title":782,"path":783,"stem":784,"children":-1},"常见问题","\u002Fdocs\u002Freference\u002Ffaq","docs\u002F04.reference\u002F18.faq",null,[787],{"title":788,"path":789,"stem":790,"children":791,"page":813},"Docs","\u002Fdocs","docs",[792,814,847,861],{"title":793,"path":794,"stem":795,"children":796,"page":813},"快速上手","\u002Fdocs\u002Fgetting-started","docs\u002F01.getting-started",[797,801,805,809],{"title":798,"path":799,"stem":800},"安装与下载","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002F01.getting-started\u002F01.installation",{"title":802,"path":803,"stem":804},"注册与登录","\u002Fdocs\u002Fgetting-started\u002Fregister-login","docs\u002F01.getting-started\u002F02.register-login",{"title":806,"path":807,"stem":808},"首次配置","\u002Fdocs\u002Fgetting-started\u002Ffirst-setup","docs\u002F01.getting-started\u002F03.first-setup",{"title":810,"path":811,"stem":812},"从 VS Code 迁移","\u002Fdocs\u002Fgetting-started\u002Fmigrate-from-vscode","docs\u002F01.getting-started\u002F04.migrate-from-vscode",false,{"title":815,"path":816,"stem":817,"children":818,"page":813},"功能指南","\u002Fdocs\u002Fguides","docs\u002F02.guides",[819,823,827,831,835,839,843],{"title":820,"path":821,"stem":822},"AI 对话与内联编辑","\u002Fdocs\u002Fguides\u002Fai-chat","docs\u002F02.guides\u002F05.ai-chat",{"title":824,"path":825,"stem":826},"RUSH 深度任务","\u002Fdocs\u002Fguides\u002Frush","docs\u002F02.guides\u002F06.rush",{"title":828,"path":829,"stem":830},"FIM 代码补全","\u002Fdocs\u002Fguides\u002Ffim-completion","docs\u002F02.guides\u002F07.fim-completion",{"title":832,"path":833,"stem":834},"语义代码图谱","\u002Fdocs\u002Fguides\u002Fcode-graph","docs\u002F02.guides\u002F08.code-graph",{"title":836,"path":837,"stem":838},"MCP 工具与市场","\u002Fdocs\u002Fguides\u002Fmcp","docs\u002F02.guides\u002F09.mcp",{"title":840,"path":841,"stem":842},"调试与 DAP","\u002Fdocs\u002Fguides\u002Fdebugging","docs\u002F02.guides\u002F10.debugging",{"title":844,"path":845,"stem":846},"集成终端","\u002Fdocs\u002Fguides\u002Fterminal","docs\u002F02.guides\u002F11.terminal",{"title":848,"path":849,"stem":850,"children":851,"page":813},"模型与计费","\u002Fdocs\u002Fmodels-billing","docs\u002F03.models-billing",[852,856,858],{"title":853,"path":854,"stem":855},"Models","\u002Fdocs\u002Fmodels-billing\u002Fmodels","docs\u002F03.models-billing\u002F12.models",{"title":645,"path":644,"stem":857},"docs\u002F03.models-billing\u002F13.plans-quota",{"title":859,"path":751,"stem":860},"自带 API Key（BYOK）","docs\u002F03.models-billing\u002F14.byok",{"title":776,"path":862,"stem":863,"children":864,"page":813},"\u002Fdocs\u002Freference","docs\u002F04.reference",[865,869,873,875,876],{"title":866,"path":867,"stem":868},"快捷键","\u002Fdocs\u002Freference\u002Fshortcuts","docs\u002F04.reference\u002F15.shortcuts",{"title":870,"path":871,"stem":872},"配置项","\u002Fdocs\u002Freference\u002Fconfiguration","docs\u002F04.reference\u002F16.configuration",{"title":41,"path":40,"stem":874},"docs\u002F04.reference\u002F17.kernel-api",{"title":782,"path":783,"stem":784},{"title":5,"path":775,"stem":778},1788543854294]