[{"data":1,"prerenderedAt":957},["ShallowReactive",2],{"docs-navigation-zh-CN":3,"/docs/start/quick-start":73,"/docs/start/quick-start-surround":953},[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":15,"body":75,"description":948,"extension":949,"meta":950,"navigation":511,"path":16,"seo":951,"stem":17,"__hash__":952},"docs/docs/1.start/1.quick-start.md",{"type":76,"value":77,"toc":930},"minimark",[78,82,152,160,163,168,175,178,180,184,226,245,251,253,257,262,336,341,344,418,423,427,586,591,594,709,714,716,720,723,741,767,772,776,778,782,784,799,803,828,831,837,840,847,849,853,906,926],[79,80,81],"p",{},"云擎数智 网关对外提供三种主要接入方式：",[83,84,85,101],"table",{},[86,87,88],"thead",{},[89,90,91,95,98],"tr",{},[92,93,94],"th",{},"接入方式",[92,96,97],{},"适合谁",[92,99,100],{},"文档入口",[102,103,104,123,137],"tbody",{},[89,105,106,113,116],{},[107,108,109],"td",{},[110,111,112],"strong",{},"V1 开放 API",[107,114,115],{},"后端、移动端、第三方 SDK 集成",[107,117,118],{},[119,120,122],"a",{"href":121},"../api/conventions","通用约定",[89,124,125,129,132],{},[107,126,127],{},[110,128,66],{},[107,130,131],{},"Claude、Cursor、Codex、OpenClaw、Hermes、NemoClaw 等 Agent",[107,133,134],{},[119,135,66],{"href":136},"../skills/skills-intro",[89,138,139,143,146],{},[107,140,141],{},[110,142,57],{},[107,144,145],{},"通过 MCP 协议接入的客户端",[107,147,148],{},[119,149,151],{"href":150},"../mcp/connection","连接与配置",[79,153,154,155,159],{},"本指南帮助你在 5 分钟内完成第一次 API 调用。示例中的 ",[156,157,158],"code",{},"sk-xxx"," 请替换为你的 API Key。",[161,162],"hr",{},[164,165,167],"h2",{"id":166},"_1-获取-api-key","1. 获取 API Key",[79,169,170,171,174],{},"在 云擎数智 管理台创建 API Key（令牌），格式通常为 ",[156,172,173],{},"sk-xxxxxxxx","。",[79,176,177],{},"如需限制模型或配置 IP 白名单，在令牌设置中完成后再用于集成。",[161,179],{},[164,181,183],{"id":182},"_2-查看可用模型","2. 查看可用模型",[185,186,191],"pre",{"className":187,"code":188,"language":189,"meta":190,"style":190},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl https://www.yunsell.com/v1/models \\\n  -H \"Authorization: Bearer sk-xxx\"\n","bash","",[156,192,193,210],{"__ignoreMap":190},[194,195,198,202,206],"span",{"class":196,"line":197},"line",1,[194,199,201],{"class":200},"sBMFI","curl",[194,203,205],{"class":204},"sfazB"," https://www.yunsell.com/v1/models",[194,207,209],{"class":208},"sTEyZ"," \\\n",[194,211,213,216,220,223],{"class":196,"line":212},2,[194,214,215],{"class":204},"  -H",[194,217,219],{"class":218},"sMK4o"," \"",[194,221,222],{"class":204},"Authorization: Bearer sk-xxx",[194,224,225],{"class":218},"\"\n",[79,227,228,229,232,233,236,237,240,241,244],{},"成功时返回 ",[156,230,231],{},"success: true"," 及 ",[156,234,235],{},"data[]"," 模型列表。记下你要使用的 ",[156,238,239],{},"data[].id","，并查看 ",[156,242,243],{},"supported_endpoint_types"," 确认该模型支持的能力。",[79,246,247,248,174],{},"详见 ",[119,249,37],{"href":250},"../api/models",[161,252],{},[164,254,256],{"id":255},"_3-按场景选择第一个接口","3. 按场景选择第一个接口",[258,259,261],"h3",{"id":260},"文本对话最常用","文本对话（最常用）",[185,263,265],{"className":187,"code":264,"language":189,"meta":190,"style":190},"curl https://www.yunsell.com/v1/chat/completions \\\n  -H \"Authorization: Bearer sk-xxx\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"model\": \"gpt-4o\",\n    \"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}]\n  }'\n",[156,266,267,276,289,303,315,321,327],{"__ignoreMap":190},[194,268,269,271,274],{"class":196,"line":197},[194,270,201],{"class":200},[194,272,273],{"class":204}," https://www.yunsell.com/v1/chat/completions",[194,275,209],{"class":208},[194,277,278,280,282,284,287],{"class":196,"line":212},[194,279,215],{"class":204},[194,281,219],{"class":218},[194,283,222],{"class":204},[194,285,286],{"class":218},"\"",[194,288,209],{"class":208},[194,290,292,294,296,299,301],{"class":196,"line":291},3,[194,293,215],{"class":204},[194,295,219],{"class":218},[194,297,298],{"class":204},"Content-Type: application/json",[194,300,286],{"class":218},[194,302,209],{"class":208},[194,304,306,309,312],{"class":196,"line":305},4,[194,307,308],{"class":204},"  -d",[194,310,311],{"class":218}," '",[194,313,314],{"class":204},"{\n",[194,316,318],{"class":196,"line":317},5,[194,319,320],{"class":204},"    \"model\": \"gpt-4o\",\n",[194,322,324],{"class":196,"line":323},6,[194,325,326],{"class":204},"    \"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}]\n",[194,328,330,333],{"class":196,"line":329},7,[194,331,332],{"class":204},"  }",[194,334,335],{"class":218},"'\n",[79,337,247,338,174],{},[119,339,41],{"href":340},"../api/text",[258,342,343],{"id":343},"文生图",[185,345,347],{"className":187,"code":346,"language":189,"meta":190,"style":190},"curl https://www.yunsell.com/v1/images/generations \\\n  -H \"Authorization: Bearer sk-xxx\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"model\": \"dall-e-3\",\n    \"prompt\": \"A cat on a windowsill\",\n    \"size\": \"1024x1024\",\n    \"response_format\": \"url\"\n  }'\n",[156,348,349,358,370,382,390,395,400,405,411],{"__ignoreMap":190},[194,350,351,353,356],{"class":196,"line":197},[194,352,201],{"class":200},[194,354,355],{"class":204}," https://www.yunsell.com/v1/images/generations",[194,357,209],{"class":208},[194,359,360,362,364,366,368],{"class":196,"line":212},[194,361,215],{"class":204},[194,363,219],{"class":218},[194,365,222],{"class":204},[194,367,286],{"class":218},[194,369,209],{"class":208},[194,371,372,374,376,378,380],{"class":196,"line":291},[194,373,215],{"class":204},[194,375,219],{"class":218},[194,377,298],{"class":204},[194,379,286],{"class":218},[194,381,209],{"class":208},[194,383,384,386,388],{"class":196,"line":305},[194,385,308],{"class":204},[194,387,311],{"class":218},[194,389,314],{"class":204},[194,391,392],{"class":196,"line":317},[194,393,394],{"class":204},"    \"model\": \"dall-e-3\",\n",[194,396,397],{"class":196,"line":323},[194,398,399],{"class":204},"    \"prompt\": \"A cat on a windowsill\",\n",[194,401,402],{"class":196,"line":329},[194,403,404],{"class":204},"    \"size\": \"1024x1024\",\n",[194,406,408],{"class":196,"line":407},8,[194,409,410],{"class":204},"    \"response_format\": \"url\"\n",[194,412,414,416],{"class":196,"line":413},9,[194,415,332],{"class":204},[194,417,335],{"class":218},[79,419,247,420,174],{},[119,421,45],{"href":422},"../api/images",[258,424,426],{"id":425},"视频生成异步","视频生成（异步）",[185,428,430],{"className":187,"code":429,"language":189,"meta":190,"style":190},"# 1. 创建任务\ncurl https://www.yunsell.com/v1/videos \\\n  -H \"Authorization: Bearer sk-xxx\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"model\": \"sora-2\",\n    \"prompt\": \"A cat walking on the beach at sunset\",\n    \"size\": \"1280x720\",\n    \"seconds\": 8\n  }'\n\n# 2. 轮询状态（将 task_xxx 替换为上一步返回的 id）\ncurl https://www.yunsell.com/v1/videos/task_xxx \\\n  -H \"Authorization: Bearer sk-xxx\"\n\n# 3. 完成后下载\ncurl -L https://www.yunsell.com/v1/videos/task_xxx/content \\\n  -H \"Authorization: Bearer sk-xxx\" \\\n  -o output.mp4\n",[156,431,432,438,447,459,471,479,484,489,494,499,506,513,519,529,540,545,551,564,577],{"__ignoreMap":190},[194,433,434],{"class":196,"line":197},[194,435,437],{"class":436},"sHwdD","# 1. 创建任务\n",[194,439,440,442,445],{"class":196,"line":212},[194,441,201],{"class":200},[194,443,444],{"class":204}," https://www.yunsell.com/v1/videos",[194,446,209],{"class":208},[194,448,449,451,453,455,457],{"class":196,"line":291},[194,450,215],{"class":204},[194,452,219],{"class":218},[194,454,222],{"class":204},[194,456,286],{"class":218},[194,458,209],{"class":208},[194,460,461,463,465,467,469],{"class":196,"line":305},[194,462,215],{"class":204},[194,464,219],{"class":218},[194,466,298],{"class":204},[194,468,286],{"class":218},[194,470,209],{"class":208},[194,472,473,475,477],{"class":196,"line":317},[194,474,308],{"class":204},[194,476,311],{"class":218},[194,478,314],{"class":204},[194,480,481],{"class":196,"line":323},[194,482,483],{"class":204},"    \"model\": \"sora-2\",\n",[194,485,486],{"class":196,"line":329},[194,487,488],{"class":204},"    \"prompt\": \"A cat walking on the beach at sunset\",\n",[194,490,491],{"class":196,"line":407},[194,492,493],{"class":204},"    \"size\": \"1280x720\",\n",[194,495,496],{"class":196,"line":413},[194,497,498],{"class":204},"    \"seconds\": 8\n",[194,500,502,504],{"class":196,"line":501},10,[194,503,332],{"class":204},[194,505,335],{"class":218},[194,507,509],{"class":196,"line":508},11,[194,510,512],{"emptyLinePlaceholder":511},true,"\n",[194,514,516],{"class":196,"line":515},12,[194,517,518],{"class":436},"# 2. 轮询状态（将 task_xxx 替换为上一步返回的 id）\n",[194,520,522,524,527],{"class":196,"line":521},13,[194,523,201],{"class":200},[194,525,526],{"class":204}," https://www.yunsell.com/v1/videos/task_xxx",[194,528,209],{"class":208},[194,530,532,534,536,538],{"class":196,"line":531},14,[194,533,215],{"class":204},[194,535,219],{"class":218},[194,537,222],{"class":204},[194,539,225],{"class":218},[194,541,543],{"class":196,"line":542},15,[194,544,512],{"emptyLinePlaceholder":511},[194,546,548],{"class":196,"line":547},16,[194,549,550],{"class":436},"# 3. 完成后下载\n",[194,552,554,556,559,562],{"class":196,"line":553},17,[194,555,201],{"class":200},[194,557,558],{"class":204}," -L",[194,560,561],{"class":204}," https://www.yunsell.com/v1/videos/task_xxx/content",[194,563,209],{"class":208},[194,565,567,569,571,573,575],{"class":196,"line":566},18,[194,568,215],{"class":204},[194,570,219],{"class":218},[194,572,222],{"class":204},[194,574,286],{"class":218},[194,576,209],{"class":208},[194,578,580,583],{"class":196,"line":579},19,[194,581,582],{"class":204},"  -o",[194,584,585],{"class":204}," output.mp4\n",[79,587,247,588,174],{},[119,589,49],{"href":590},"../api/videos",[258,592,593],{"id":593},"文本转语音",[185,595,597],{"className":187,"code":596,"language":189,"meta":190,"style":190},"# 1. 查询音色\ncurl https://www.yunsell.com/v1/audio/voice/tts-1 \\\n  -H \"Authorization: Bearer sk-xxx\"\n\n# 2. 合成语音\ncurl https://www.yunsell.com/v1/audio/speech \\\n  -H \"Authorization: Bearer sk-xxx\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"model\": \"tts-1\",\n    \"input\": \"Hello world\",\n    \"voice\": \"alloy\",\n    \"response_format\": \"mp3\"\n  }' \\\n  -o speech.mp3\n",[156,598,599,604,613,623,627,632,641,653,665,673,678,683,688,693,702],{"__ignoreMap":190},[194,600,601],{"class":196,"line":197},[194,602,603],{"class":436},"# 1. 查询音色\n",[194,605,606,608,611],{"class":196,"line":212},[194,607,201],{"class":200},[194,609,610],{"class":204}," https://www.yunsell.com/v1/audio/voice/tts-1",[194,612,209],{"class":208},[194,614,615,617,619,621],{"class":196,"line":291},[194,616,215],{"class":204},[194,618,219],{"class":218},[194,620,222],{"class":204},[194,622,225],{"class":218},[194,624,625],{"class":196,"line":305},[194,626,512],{"emptyLinePlaceholder":511},[194,628,629],{"class":196,"line":317},[194,630,631],{"class":436},"# 2. 合成语音\n",[194,633,634,636,639],{"class":196,"line":323},[194,635,201],{"class":200},[194,637,638],{"class":204}," https://www.yunsell.com/v1/audio/speech",[194,640,209],{"class":208},[194,642,643,645,647,649,651],{"class":196,"line":329},[194,644,215],{"class":204},[194,646,219],{"class":218},[194,648,222],{"class":204},[194,650,286],{"class":218},[194,652,209],{"class":208},[194,654,655,657,659,661,663],{"class":196,"line":407},[194,656,215],{"class":204},[194,658,219],{"class":218},[194,660,298],{"class":204},[194,662,286],{"class":218},[194,664,209],{"class":208},[194,666,667,669,671],{"class":196,"line":413},[194,668,308],{"class":204},[194,670,311],{"class":218},[194,672,314],{"class":204},[194,674,675],{"class":196,"line":501},[194,676,677],{"class":204},"    \"model\": \"tts-1\",\n",[194,679,680],{"class":196,"line":508},[194,681,682],{"class":204},"    \"input\": \"Hello world\",\n",[194,684,685],{"class":196,"line":515},[194,686,687],{"class":204},"    \"voice\": \"alloy\",\n",[194,689,690],{"class":196,"line":521},[194,691,692],{"class":204},"    \"response_format\": \"mp3\"\n",[194,694,695,697,700],{"class":196,"line":531},[194,696,332],{"class":204},[194,698,699],{"class":218},"'",[194,701,209],{"class":208},[194,703,704,706],{"class":196,"line":542},[194,705,582],{"class":204},[194,707,708],{"class":204}," speech.mp3\n",[79,710,247,711,174],{},[119,712,53],{"href":713},"../api/audio",[161,715],{},[164,717,719],{"id":718},"_4-在-agent-中使用-skills可选","4. 在 Agent 中使用 Skills（可选）",[79,721,722],{},"若你使用 Claude、Cursor、Codex、OpenClaw、Hermes、NemoClaw 等 Agent 平台：",[724,725,726,734],"ol",{},[727,728,729,730,733],"li",{},"下载并解压 ",[156,731,732],{},"yunsell-ai-skills.zip"," 到 Agent 的 Skills 目录",[727,735,736,737,740],{},"在 ",[156,738,739],{},"yunsell-ai-skills/.env"," 中配置：",[185,742,744],{"className":187,"code":743,"language":189,"meta":190,"style":190},"YUNSELL_BASE_URL=https://www.yunsell.com\nYUNSELL_API_KEY=sk-xxx\n",[156,745,746,757],{"__ignoreMap":190},[194,747,748,751,754],{"class":196,"line":197},[194,749,750],{"class":208},"YUNSELL_BASE_URL",[194,752,753],{"class":218},"=",[194,755,756],{"class":204},"https://www.yunsell.com\n",[194,758,759,762,764],{"class":196,"line":212},[194,760,761],{"class":208},"YUNSELL_API_KEY",[194,763,753],{"class":218},[194,765,766],{"class":204},"sk-xxx\n",[724,768,769],{"start":291},[727,770,771],{},"在对话中直接描述生成需求",[79,773,247,774,174],{},[119,775,66],{"href":136},[161,777],{},[164,779,781],{"id":780},"_5-文档导航","5. 文档导航",[258,783,10],{"id":10},[785,786,787,793],"ul",{},[727,788,789,792],{},[119,790,19],{"href":791},"./guide"," — REST vs Skills vs MCP",[727,794,795,798],{},[119,796,23],{"href":797},"./glossary"," — 常见概念说明",[258,800,802],{"id":801},"v1-开放-api12-条","V1 开放 API（12 条）",[785,804,805,810],{},[727,806,807,809],{},[119,808,122],{"href":121}," — 鉴权、错误、计费、公共对象",[727,811,812,815,816,815,819,815,822,815,825],{},[119,813,814],{"href":250},"模型"," · ",[119,817,818],{"href":340},"文本",[119,820,821],{"href":422},"图像",[119,823,824],{"href":590},"视频",[119,826,827],{"href":713},"音频",[258,829,57],{"id":830},"mcp-服务",[785,832,833],{},[727,834,835],{},[119,836,151],{"href":150},[258,838,66],{"id":839},"skills",[785,841,842],{},[727,843,844],{},[119,845,846],{"href":136},"Skills 介绍",[161,848],{},[164,850,852],{"id":851},"_6-下一步","6. 下一步",[83,854,855,865],{},[86,856,857],{},[89,858,859,862],{},[92,860,861],{},"目标",[92,863,864],{},"阅读",[102,866,867,876,886,895],{},[89,868,869,872],{},[107,870,871],{},"了解 REST / Skills 如何选型",[107,873,874],{},[119,875,19],{"href":791},[89,877,878,881],{},[107,879,880],{},"查阅完整接口参数",[107,882,883],{},[119,884,885],{"href":250},"API 能力文档",[89,887,888,891],{},[107,889,890],{},"在 Agent 中调用多模态",[107,892,893],{},[119,894,66],{"href":136},[89,896,897,900],{},[107,898,899],{},"理解错误与计费",[107,901,902],{},[119,903,905],{"href":904},"../api/conventions#%E9%94%99%E8%AF%AF%E5%93%8D%E5%BA%94","通用约定 · 错误响应",[79,907,908,911,912,915,916,918,919,922,923],{},[110,909,910],{},"通用约定速查","：Base URL ",[156,913,914],{},"https://www.yunsell.com"," · 鉴权 ",[156,917,222],{}," · 公开 API ",[156,920,921],{},"/v1/*"," · MCP ",[156,924,925],{},"/mcp",[927,928,929],"style",{},"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 .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 .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":190,"searchDepth":212,"depth":212,"links":931},[932,933,934,940,941,947],{"id":166,"depth":212,"text":167},{"id":182,"depth":212,"text":183},{"id":255,"depth":212,"text":256,"children":935},[936,937,938,939],{"id":260,"depth":291,"text":261},{"id":343,"depth":291,"text":343},{"id":425,"depth":291,"text":426},{"id":593,"depth":291,"text":593},{"id":718,"depth":212,"text":719},{"id":780,"depth":212,"text":781,"children":942},[943,944,945,946],{"id":10,"depth":291,"text":10},{"id":801,"depth":291,"text":802},{"id":830,"depth":291,"text":57},{"id":839,"depth":291,"text":66},{"id":851,"depth":212,"text":852},"5 分钟内完成第一次 API 调用，了解 V1 API、Skills 与 MCP 三种接入方式","md",{},{"title":15,"description":948},"h80hlZVu4kitoglE2WL9YOajfPA2cEiEnuT8KJ9DT-w",[954,955],null,{"title":19,"path":20,"stem":21,"description":956,"children":-1},"按使用场景选择 V1 开放 API、Skills 或 MCP 接入方式",1787808399511]