[{"data":1,"prerenderedAt":1110},["ShallowReactive",2],{"guide-\u002Fguides-zh\u002Ffor-agents":3,"developer-code-34eaj7":1098,"developer-code-7a8atz":1099,"developer-code-1svhdzf":1100,"developer-code-1gs3h2m":1101,"developer-code-1ex5t56":1102,"developer-code-9on7ab":1103,"developer-code-zvmysn":1104,"developer-code-2u142j":1105,"developer-code-1tp71zs":1106,"developer-code-c47igf":1107,"developer-code-1ue5dp2":1108,"developer-code-1gdh9rw":1109},{"id":4,"title":5,"body":6,"description":1088,"extension":1089,"meta":1090,"navigation":1091,"path":1094,"seo":1095,"stem":1096,"__hash__":1097},"guidesZh\u002Fguides-zh\u002Ffor-agents.md","让 AI Agent 使用 VisionStory API",{"type":7,"value":8,"toc":1071},"minimark",[9,18,23,126,129,158,181,185,192,201,212,236,239,257,268,365,375,383,390,415,418,442,446,456,525,531,534,545,549,555,641,651,675,679,694,719,735,738,779,801,849,853,856,863,869,873,876,882,905,909,963,967,1002,1006,1024,1053,1067],[10,11,12,13,17],"p",{},"AI Agent 可以通过 MCP、Python SDK、CLI 或机器可读文档生成 VisionStory 视频、图像、语音、数字人形象和声音。Agent Skill 涵盖数字人视频生成、声音查询、指定语言地区的语音合成、音频转写和逐词对齐。所有接入方式使用同一个 REST API 和 ",[14,15,16],"code",{},"VISIONSTORY_API_KEY","，请按 Agent 的运行环境选择。",[19,20,22],"h2",{"id":21},"choose-an-ai-agent-integration","选择 Agent 接入方式",[24,25,26,42],"table",{},[27,28,29],"thead",{},[30,31,32,36,39],"tr",{},[33,34,35],"th",{},"方式",[33,37,38],{},"安装",[33,40,41],{},"适用场景",[43,44,45,63,79,94,109],"tbody",{},[30,46,47,54,60],{},[48,49,50],"td",{},[51,52,53],"strong",{},"MCP Server",[48,55,56,59],{},[14,57,58],{},"uvx visionstory-mcp"," — 由客户端启动，无需托管服务",[48,61,62],{},"Claude Desktop、编码 Agent 和其他本地 MCP 客户端",[30,64,65,70,76],{},[48,66,67],{},[51,68,69],{},"CLI",[48,71,72,75],{},[14,73,74],{},"curl -fsSL https:\u002F\u002Fdevelopers.visionstory.ai\u002Fcli | bash","（最新版本）",[48,77,78],{},"希望长期使用同一个终端命令的用户和 Agent",[30,80,81,86,91],{},[48,82,83],{},[51,84,85],{},"Python SDK",[48,87,88],{},[14,89,90],{},"pip install visionstory",[48,92,93],{},"能编写并运行 Python 的 Agent",[30,95,96,101,106],{},[48,97,98],{},[51,99,100],{},"Agent Skill",[48,102,103],{},[14,104,105],{},"npx skills add visionstory-ai\u002Fskills --skill visionstory-api",[48,107,108],{},"支持 Skill、需要在仓库中处理数字人、语音或音频的编码 Agent",[30,110,111,120,123],{},[48,112,113],{},[51,114,115,116,119],{},"llms.txt + ",[14,117,118],{},".md"," 页面",[48,121,122],{},"无需安装，直接访问 URL",[48,124,125],{},"能浏览网页、按需阅读文档的 Agent",[10,127,128],{},"无论选择哪种方式，都通过环境变量为 Agent 提供密钥。变量缺失时，Agent 应说明如何在本地配置，绝不能要求你把密钥粘贴到聊天中：",[130,131,136],"pre",{"className":132,"code":133,"language":134,"meta":135,"style":135},"language-bash shiki shiki-themes github-light github-dark","export VISIONSTORY_API_KEY=\"sk-vs-xxxxxxxxxxxxxxxxxxx\"\n","bash","",[14,137,138],{"__ignoreMap":135},[139,140,143,147,151,154],"span",{"class":141,"line":142},"line",1,[139,144,146],{"class":145},"szBVR","export",[139,148,150],{"class":149},"sVt8B"," VISIONSTORY_API_KEY",[139,152,153],{"class":145},"=",[139,155,157],{"class":156},"sZZnC","\"sk-vs-xxxxxxxxxxxxxxxxxxx\"\n",[10,159,160,161,164,165,168,169,172,173,180],{},"让 Agent 提交付费生成前，先运行只读命令 ",[14,162,163],{},"visionstory credits","，或调用 MCP 的 ",[14,166,167],{},"get_credits"," 工具。返回 ",[14,170,171],{},"401"," 表示本地密钥缺失、过期或无效，请到 ",[174,175,179],"a",{"href":176,"rel":177},"https:\u002F\u002Fdevelopers.visionstory.ai\u002Fapi-keys",[178],"nofollow","API Key 页面","更换。",[19,182,184],{"id":183},"connect-the-visionstory-mcp-server","连接 VisionStory MCP Server",[10,186,187,188,191],{},"多数用户使用下方推荐的本地配置即可。MCP 客户端按需启动 VisionStory，提供与 SDK、CLI 一致的 ",[51,189,190],{},"27 个公共操作","，包括音频转写与对齐。",[193,194,196,197,200],"h3",{"id":195},"recommended-setup-run-with-uvx","推荐：使用 ",[14,198,199],{},"uvx"," 运行",[10,202,203,204,207,208,211],{},"安装一次 ",[14,205,206],{},"uv"," 即可。如果 ",[14,209,210],{},"uvx --version"," 已能正常运行，可跳过：",[130,213,215],{"className":132,"code":214,"language":134,"meta":135,"style":135},"curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n",[14,216,217],{"__ignoreMap":135},[139,218,219,223,227,230,233],{"class":141,"line":142},[139,220,222],{"class":221},"sScJk","curl",[139,224,226],{"class":225},"sj4cs"," -LsSf",[139,228,229],{"class":156}," https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh",[139,231,232],{"class":145}," |",[139,234,235],{"class":221}," sh\n",[10,237,238],{},"确认 VisionStory MCP 能正常启动：",[130,240,242],{"className":132,"code":241,"language":134,"meta":135,"style":135},"uvx --refresh visionstory-mcp --check\n",[14,243,244],{"__ignoreMap":135},[139,245,246,248,251,254],{"class":141,"line":142},[139,247,199],{"class":221},[139,249,250],{"class":225}," --refresh",[139,252,253],{"class":156}," visionstory-mcp",[139,255,256],{"class":225}," --check\n",[10,258,259,260,263,264,267],{},"看到 ",[14,261,262],{},"✓ VisionStory MCP started successfully"," 后，将以下配置加入 MCP 客户端。Claude Desktop 的入口为 ",[51,265,266],{},"Settings → Developer → Edit Config","：",[130,269,273],{"className":270,"code":271,"language":272,"meta":135,"style":135},"language-json shiki shiki-themes github-light github-dark","{\n  \"mcpServers\": {\n    \"visionstory\": {\n      \"command\": \"uvx\",\n      \"args\": [\"visionstory-mcp\"],\n      \"env\": { \"VISIONSTORY_API_KEY\": \"YOUR_LOCAL_VISIONSTORY_API_KEY\" }\n    }\n  }\n}\n","json",[14,274,275,280,289,297,312,327,347,353,359],{"__ignoreMap":135},[139,276,277],{"class":141,"line":142},[139,278,279],{"class":149},"{\n",[139,281,283,286],{"class":141,"line":282},2,[139,284,285],{"class":225},"  \"mcpServers\"",[139,287,288],{"class":149},": {\n",[139,290,292,295],{"class":141,"line":291},3,[139,293,294],{"class":225},"    \"visionstory\"",[139,296,288],{"class":149},[139,298,300,303,306,309],{"class":141,"line":299},4,[139,301,302],{"class":225},"      \"command\"",[139,304,305],{"class":149},": ",[139,307,308],{"class":156},"\"uvx\"",[139,310,311],{"class":149},",\n",[139,313,315,318,321,324],{"class":141,"line":314},5,[139,316,317],{"class":225},"      \"args\"",[139,319,320],{"class":149},": [",[139,322,323],{"class":156},"\"visionstory-mcp\"",[139,325,326],{"class":149},"],\n",[139,328,330,333,336,339,341,344],{"class":141,"line":329},6,[139,331,332],{"class":225},"      \"env\"",[139,334,335],{"class":149},": { ",[139,337,338],{"class":225},"\"VISIONSTORY_API_KEY\"",[139,340,305],{"class":149},[139,342,343],{"class":156},"\"YOUR_LOCAL_VISIONSTORY_API_KEY\"",[139,345,346],{"class":149}," }\n",[139,348,350],{"class":141,"line":349},7,[139,351,352],{"class":149},"    }\n",[139,354,356],{"class":141,"line":355},8,[139,357,358],{"class":149},"  }\n",[139,360,362],{"class":141,"line":361},9,[139,363,364],{"class":149},"}\n",[10,366,367,368,370,371,374],{},"只在本地客户端配置中替换 API Key 占位符，然后重启客户端。让 Agent 调用 ",[14,369,167],{}," 和 ",[14,372,373],{},"list_models","；两者成功即表示连接就绪。",[193,376,378,379,382],{"id":377},"alternative-install-with-pip","备选：使用 ",[14,380,381],{},"pip"," 安装",[10,384,385,386,389],{},"仅在希望长期安装 ",[14,387,388],{},"visionstory-mcp"," 命令时使用此方式：",[130,391,393],{"className":132,"code":392,"language":134,"meta":135,"style":135},"python3 -m pip install --upgrade visionstory-mcp\n",[14,394,395],{"__ignoreMap":135},[139,396,397,400,403,406,409,412],{"class":141,"line":142},[139,398,399],{"class":221},"python3",[139,401,402],{"class":225}," -m",[139,404,405],{"class":156}," pip",[139,407,408],{"class":156}," install",[139,410,411],{"class":225}," --upgrade",[139,413,414],{"class":156}," visionstory-mcp\n",[10,416,417],{},"在上面的配置中，将命令与参数替换为：",[130,419,421],{"className":270,"code":420,"language":272,"meta":135,"style":135},"\"command\": \"visionstory-mcp\",\n\"args\": []\n",[14,422,423,434],{"__ignoreMap":135},[139,424,425,428,430,432],{"class":141,"line":142},[139,426,427],{"class":156},"\"command\"",[139,429,305],{"class":149},[139,431,323],{"class":156},[139,433,311],{"class":149},[139,435,436,439],{"class":141,"line":282},[139,437,438],{"class":156},"\"args\"",[139,440,441],{"class":149},": []\n",[193,443,445],{"id":444},"advanced-connect-to-a-remote-mcp-endpoint","进阶：连接远程 MCP 服务",[10,447,448,449,451,452,455],{},"前面的本地 ",[14,450,58],{}," 仍是最简单的方式，并且支持访问你电脑上的文件。需要集中管理 MCP 的团队，也可以部署仓库中的无状态 Streamable HTTP 服务，再连接其 ",[14,453,454],{},"\u002Fmcp"," 接口。",[130,457,459],{"className":270,"code":458,"language":272,"meta":135,"style":135},"{\n  \"mcpServers\": {\n    \"visionstory-remote\": {\n      \"url\": \"https:\u002F\u002FYOUR_MCP_HOST\u002Fmcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_LOCAL_VISIONSTORY_API_KEY\"\n      }\n    }\n  }\n}\n",[14,460,461,465,471,478,490,497,507,512,516,520],{"__ignoreMap":135},[139,462,463],{"class":141,"line":142},[139,464,279],{"class":149},[139,466,467,469],{"class":141,"line":282},[139,468,285],{"class":225},[139,470,288],{"class":149},[139,472,473,476],{"class":141,"line":291},[139,474,475],{"class":225},"    \"visionstory-remote\"",[139,477,288],{"class":149},[139,479,480,483,485,488],{"class":141,"line":299},[139,481,482],{"class":225},"      \"url\"",[139,484,305],{"class":149},[139,486,487],{"class":156},"\"https:\u002F\u002FYOUR_MCP_HOST\u002Fmcp\"",[139,489,311],{"class":149},[139,491,492,495],{"class":141,"line":314},[139,493,494],{"class":225},"      \"headers\"",[139,496,288],{"class":149},[139,498,499,502,504],{"class":141,"line":329},[139,500,501],{"class":225},"        \"Authorization\"",[139,503,305],{"class":149},[139,505,506],{"class":156},"\"Bearer YOUR_LOCAL_VISIONSTORY_API_KEY\"\n",[139,508,509],{"class":141,"line":349},[139,510,511],{"class":149},"      }\n",[139,513,514],{"class":141,"line":355},[139,515,352],{"class":149},[139,517,518],{"class":141,"line":361},[139,519,358],{"class":149},[139,521,523],{"class":141,"line":522},10,[139,524,364],{"class":149},[10,526,527,528,530],{},"这种方式适用于自行运行共享 MCP 服务的团队。本地文件需要先上传，或通过 HTTP(S) 提供访问；Agent 需要直接读取你电脑上的文件时，请选择 ",[14,529,199],{},"。",[10,532,533],{},"无论如何配置，API Key 都应只保存在本地，不要粘贴到聊天或提交到 Git。生成工具默认等待结果，删除工具要求明确确认。",[10,535,536,537,540,541,544],{},"本地 MCP Server 启动时会检查包的新版本，并通过 ",[14,538,539],{},"visionstory:\u002F\u002Frelease"," 提供已安装版本、最新版本、功能亮点、更新日志和升级命令。检查结果会缓存，离线时静默跳过。设置 ",[14,542,543],{},"VISIONSTORY_UPDATE_CHECK=0"," 可关闭检查。远程 MCP 服务由服务端集中管理和更新，也提供相同资源；重新连接 MCP 客户端即可刷新可用工具。",[19,546,548],{"id":547},"use-the-python-sdk-from-an-agent","让 Agent 使用 Python SDK",[10,550,551,552,554],{},"如果 Agent 可以编写和运行代码，通过 ",[14,553,90],{}," 即可获得带类型定义、无运行时依赖的客户端：",[130,556,560],{"className":557,"code":558,"language":559,"meta":135,"style":135},"language-python shiki shiki-themes github-light github-dark","from visionstory import VisionStoryClient, build_video_payload\n\nclient = VisionStoryClient.from_env()   # reads VISIONSTORY_API_KEY\nvideo = client.generate_video(build_video_payload(\n    avatar_id=\"YOUR_AVATAR_ID\", text=\"Hello from VisionStory.\", voice_id=\"YOUR_VOICE_ID\"))\n","python",[14,561,562,576,582,596,606],{"__ignoreMap":135},[139,563,564,567,570,573],{"class":141,"line":142},[139,565,566],{"class":145},"from",[139,568,569],{"class":149}," visionstory ",[139,571,572],{"class":145},"import",[139,574,575],{"class":149}," VisionStoryClient, build_video_payload\n",[139,577,578],{"class":141,"line":282},[139,579,581],{"emptyLinePlaceholder":580},true,"\n",[139,583,584,587,589,592],{"class":141,"line":291},[139,585,586],{"class":149},"client ",[139,588,153],{"class":145},[139,590,591],{"class":149}," VisionStoryClient.from_env()   ",[139,593,595],{"class":594},"sJ8bj","# reads VISIONSTORY_API_KEY\n",[139,597,598,601,603],{"class":141,"line":299},[139,599,600],{"class":149},"video ",[139,602,153],{"class":145},[139,604,605],{"class":149}," client.generate_video(build_video_payload(\n",[139,607,608,612,614,617,620,623,625,628,630,633,635,638],{"class":141,"line":314},[139,609,611],{"class":610},"s4XuR","    avatar_id",[139,613,153],{"class":145},[139,615,616],{"class":156},"\"YOUR_AVATAR_ID\"",[139,618,619],{"class":149},", ",[139,621,622],{"class":610},"text",[139,624,153],{"class":145},[139,626,627],{"class":156},"\"Hello from VisionStory.\"",[139,629,619],{"class":149},[139,631,632],{"class":610},"voice_id",[139,634,153],{"class":145},[139,636,637],{"class":156},"\"YOUR_VOICE_ID\"",[139,639,640],{"class":149},"))\n",[10,642,643,644,370,647,650],{},"构建请求前，先从 ",[14,645,646],{},"client.list_avatars()",[14,648,649],{},"client.list_voices()"," 获取并选择两个 ID。示例中的值只是占位符，不代表一定存在的资源。",[10,652,653,654,657,658,661,662,666,667,670,671,674],{},"偏好终端时，运行 ",[14,655,656],{},"pip install visionstory-cli"," 可安装 ",[14,659,660],{},"visionstory"," ",[174,663,665],{"href":664},"\u002Fguides\u002Fcli","命令行工具","，Agent 无需写代码就能运行 ",[14,668,669],{},"visionstory create-video ...","。完整客户端说明见 ",[174,672,85],{"href":673},"\u002Fguides\u002Fsdk"," 指南。",[19,676,678],{"id":677},"install-the-visionstory-agent-skill","安装 VisionStory Agent Skill",[10,680,681,682,690,691,267],{},"对于支持 Skill 的编码 Agent（如 Claude Code、Codex），可以直接从 GitHub 安装。",[174,683,686,689],{"href":684,"rel":685},"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fskills",[178],[14,687,688],{},"skills"," CLI"," 会自动检测 Agent，并将 Skill 放入 ",[14,692,693],{},".agents\u002Fskills\u002F",[130,695,697],{"className":132,"code":696,"language":134,"meta":135,"style":135},"npx skills add visionstory-ai\u002Fskills --skill visionstory-api\n",[14,698,699],{"__ignoreMap":135},[139,700,701,704,707,710,713,716],{"class":141,"line":142},[139,702,703],{"class":221},"npx",[139,705,706],{"class":156}," skills",[139,708,709],{"class":156}," add",[139,711,712],{"class":156}," visionstory-ai\u002Fskills",[139,714,715],{"class":225}," --skill",[139,717,718],{"class":156}," visionstory-api\n",[10,720,721,722,725,726,729,730,530],{},"安装器可能显示 Snyk 警告 ",[14,723,724],{},"W011","，因为你要求数字人朗读的文本会发送到 ",[14,727,728],{},"POST \u002Fapi\u002Fv1\u002Fvideo","。这次网络传输是 Skill 的正常用途，并非未声明的依赖。接受前，请查看生成的安全审计链接和公开的 ",[174,731,734],{"href":732,"rel":733},"https:\u002F\u002Fgithub.com\u002Fvisionstory-ai\u002Fskills",[178],"Skill 源码",[10,736,737],{},"没有 Node 时，可以克隆仓库并手动复制 Skill 目录：",[130,739,741],{"className":132,"code":740,"language":134,"meta":135,"style":135},"git clone https:\u002F\u002Fgithub.com\u002Fvisionstory-ai\u002Fskills.git\nmkdir -p .agents\u002Fskills\ncp -r skills\u002Fvisionstory-api .agents\u002Fskills\u002F\n",[14,742,743,754,765],{"__ignoreMap":135},[139,744,745,748,751],{"class":141,"line":142},[139,746,747],{"class":221},"git",[139,749,750],{"class":156}," clone",[139,752,753],{"class":156}," https:\u002F\u002Fgithub.com\u002Fvisionstory-ai\u002Fskills.git\n",[139,755,756,759,762],{"class":141,"line":282},[139,757,758],{"class":221},"mkdir",[139,760,761],{"class":225}," -p",[139,763,764],{"class":156}," .agents\u002Fskills\n",[139,766,767,770,773,776],{"class":141,"line":291},[139,768,769],{"class":221},"cp",[139,771,772],{"class":225}," -r",[139,774,775],{"class":156}," skills\u002Fvisionstory-api",[139,777,778],{"class":156}," .agents\u002Fskills\u002F\n",[10,780,781,782,785,786,789,790,795,796,800],{},"包内包含 ",[14,783,784],{},"SKILL.md","（Agent 遵循的工作流说明），以及无依赖的 Python 辅助程序 ",[14,787,788],{},"scripts\u002Fvisionstory_api.py","，用于查询资源、生成数字人视频、合成指定语言地区的语音、转写音频、逐词对齐、轮询和下载。若 Agent 需要全部 27 个公共操作，包括 AI 视频、图像生成和可复用素材，请使用 MCP、独立 CLI 或 Python SDK。支持 Skill 的 Agent 会自动识别它。你也可以不下载，直接",[174,791,794],{"href":792,"rel":793},"https:\u002F\u002Fdevelopers.visionstory.ai\u002Fskills\u002Fvisionstory-api\u002FSKILL.md",[178],"查看开发者站的 SKILL.md","，或使用公开分发镜像 ",[174,797,799],{"href":732,"rel":798},[178],"github.com\u002Fvisionstory-ai\u002Fskills","。辅助程序也可以独立运行：",[130,802,804],{"className":132,"code":803,"language":134,"meta":135,"style":135},"python3 .agents\u002Fskills\u002Fvisionstory-api\u002Fscripts\u002Fvisionstory_api.py models\npython3 .agents\u002Fskills\u002Fvisionstory-api\u002Fscripts\u002Fvisionstory_api.py create-video --avatar-id YOUR_AVATAR_ID --text \"Hello from VisionStory.\" --voice-id YOUR_VOICE_ID --output result.mp4\n",[14,805,806,816],{"__ignoreMap":135},[139,807,808,810,813],{"class":141,"line":142},[139,809,399],{"class":221},[139,811,812],{"class":156}," .agents\u002Fskills\u002Fvisionstory-api\u002Fscripts\u002Fvisionstory_api.py",[139,814,815],{"class":156}," models\n",[139,817,818,820,822,825,828,831,834,837,840,843,846],{"class":141,"line":282},[139,819,399],{"class":221},[139,821,812],{"class":156},[139,823,824],{"class":156}," create-video",[139,826,827],{"class":225}," --avatar-id",[139,829,830],{"class":156}," YOUR_AVATAR_ID",[139,832,833],{"class":225}," --text",[139,835,836],{"class":156}," \"Hello from VisionStory.\"",[139,838,839],{"class":225}," --voice-id",[139,841,842],{"class":156}," YOUR_VOICE_ID",[139,844,845],{"class":225}," --output",[139,847,848],{"class":156}," result.mp4\n",[19,850,852],{"id":851},"give-agents-llmstxt-and-openapi","向 Agent 提供 llms.txt 和 OpenAPI",[10,854,855],{},"将文档索引交给能访问网页的 Agent，索引会链接到适合 Agent 阅读的各篇指南：",[130,857,861],{"className":858,"code":860,"language":622,"meta":135},[859],"language-text","Read https:\u002F\u002Fdevelopers.visionstory.ai\u002Fllms.txt for the VisionStory API docs index.\nAppend .md to any guide URL to get that guide as Markdown.\nLoad the one guide that matches the task, then use OpenAPI for exact fields.\nUse https:\u002F\u002Fdevelopers.visionstory.ai\u002Fllms-full.txt only when the task spans several capabilities.\nUse https:\u002F\u002Fdevelopers.visionstory.ai\u002Fopenapi.json for the complete machine-readable API contract.\n",[14,862,860],{"__ignoreMap":135},[10,864,865,866,868],{},"也可以直接把单篇 ",[14,867,118],{}," 指南 URL 或 OpenAPI JSON URL 交给 Agent。",[19,870,872],{"id":871},"generate-a-video-with-one-agent-instruction","用一条指令生成视频",[10,874,875],{},"安装 Skill 或连接 MCP Server 后，可用一条指令生成视频：",[877,878,879],"blockquote",{},[10,880,881],{},"Create a talking-avatar video that says \"Welcome to our launch week!\", pick a friendly public avatar and an energetic voice, wait for it to finish, and save it as launch.mp4.",[10,883,884,885,887,888,891,892,895,896,899,900,904],{},"Agent 会查询形象和声音，提交 ",[14,886,728],{},"，轮询 ",[14,889,890],{},"GET \u002Fapi\u002Fv1\u002Fvideo?video_id=..."," 至 ",[14,893,894],{},"created","，再下载 ",[14,897,898],{},"video_url","，与",[174,901,903],{"href":902},"\u002Fguides\u002Fquick-start","快速开始","中的流程一致。",[19,906,908],{"id":907},"security-and-reliability-rules-for-agents","Agent 安全与可靠性规则",[910,911,912,919,922,936,939,946,949,956],"ul",{},[913,914,915,916,918],"li",{},"从 ",[14,917,16],{}," 读取密钥，不得打印、记录到日志或提交到仓库。",[913,920,921],{},"如果密钥缺失，说明如何在本地配置，不得要求用户将其粘贴到聊天中。",[913,923,924,925,928,929,928,932,935],{},"通过资源查询（",[14,926,927],{},"GET \u002Fapi\u002Fv1\u002Fmodels","、",[14,930,931],{},"\u002Fapi\u002Fv1\u002Favatars",[14,933,934],{},"\u002Fapi\u002Fv1\u002Fvoices","）获取 ID，不要猜测。",[913,937,938],{},"文档中的 ID 均视为占位符，只有查询或创建请求真实返回的 ID 才能使用。",[913,940,941,942,945],{},"创建操作支持 ",[14,943,944],{},"client_request_id"," 时应传入，避免网络重试产生第二个付费任务。",[913,947,948],{},"轮询间隔不短于 5 秒；除非用户要求继续等待，否则 10 分钟后停止。",[913,950,951,952,955],{},"明确处理 ",[14,953,954],{},"failed"," 状态，并报告服务端错误信息，注意隐去凭证。",[913,957,958,959,962],{},"调用 ",[14,960,961],{},"DELETE"," 前，必须有用户的明确请求，并在执行前再次确认。",[19,964,966],{"id":965},"related-visionstory-developer-guides","相关 VisionStory 开发指南",[910,968,969,974,981,988,995],{},[913,970,971,973],{},[174,972,903],{"href":902}," — 底层五步流程。",[913,975,976,980],{},[174,977,979],{"href":978},"\u002Fguides\u002Fai-video","AI 视频"," — Agent 使用有效 Pro 订阅的 API Key 进行文生视频和图生视频。",[913,982,983,987],{},[174,984,986],{"href":985},"\u002Fguides\u002Faudio-understanding","音频转写与对齐"," — 语音转文字、SRT、说话人标签和词级时间戳。",[913,989,990,994],{},[174,991,993],{"href":992},"\u002Freference","API 参考"," — 查看各接入方式所使用的全部接口。",[913,996,997,1001],{},[174,998,1000],{"href":999},"\u002Fguides\u002Fchangelog","更新日志"," — 文档版本、API 变更和弃用状态。",[19,1003,1005],{"id":1004},"structured-media-understanding","结构化媒体理解",[10,1007,1008,1009,1012,1013,1016,1017,370,1020,1023],{},"使用 ",[14,1010,1011],{},"understand_media(prompt, inputs, schema)"," 从 1–8 个图片、音频片段或视频中提取结构化数据。提示词必须为 1–5000 字符，JSON Schema 顶层必须是对象。同步调用最长等待 180 秒，返回 ",[14,1014,1015],{},"output","、token ",[14,1018,1019],{},"usage",[14,1021,1022],{},"cost_credit","；不提供模型选择或自由文本模式。成功调用会计费，因此超时后不要自动重复请求。",[10,1025,1026,1027,1030,1031,1034,1035,1038,1039,1042,1043,928,1046,928,1049,1052],{},"远程 MCP 接受媒体 URL 或素材 ID，本地 MCP 还支持 ",[14,1028,1029],{},"inline_data","。Agent Skill 辅助程序提供 ",[14,1032,1033],{},"understand-media --prompt ... --inputs ... --schema ...","。两种 MCP 的 ",[14,1036,1037],{},"create_speech"," 均支持可选 ",[14,1040,1041],{},"speech_rate","（",[14,1044,1045],{},"slow",[14,1047,1048],{},"normal",[14,1050,1051],{},"fast","）；省略或传入 null 时使用正常语速。",[10,1054,1055,1056,1061,1062,530],{},"完整接口约定见",[174,1057,1060],{"href":1058,"rel":1059},"https:\u002F\u002Fdevelopers.visionstory.ai\u002Fguides\u002Fmedia-understanding",[178],"媒体理解","和",[174,1063,1066],{"href":1064,"rel":1065},"https:\u002F\u002Fdevelopers.visionstory.ai\u002Fguides\u002Ftext-to-speech",[178],"文本转语音",[1068,1069,1070],"style",{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}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 .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":135,"searchDepth":282,"depth":282,"links":1072},[1073,1074,1081,1082,1083,1084,1085,1086,1087],{"id":21,"depth":282,"text":22},{"id":183,"depth":282,"text":184,"children":1075},[1076,1078,1080],{"id":195,"depth":291,"text":1077},"推荐：使用 uvx 运行",{"id":377,"depth":291,"text":1079},"备选：使用 pip 安装",{"id":444,"depth":291,"text":445},{"id":547,"depth":282,"text":548},{"id":677,"depth":282,"text":678},{"id":851,"depth":282,"text":852},{"id":871,"depth":282,"text":872},{"id":907,"depth":282,"text":908},{"id":965,"depth":282,"text":966},{"id":1004,"depth":282,"text":1005},"通过 MCP、Agent Skill、Python SDK、CLI、llms.txt 和 OpenAPI 连接 VisionStory，让 AI Agent 安全地自动生成媒体。","md",{},{"title":1092,"order":1093},"面向 Agent",11,"\u002Fguides-zh\u002Ffor-agents",{"title":5,"description":1088},"guides-zh\u002Ffor-agents","zmcPcrZabadNw6p_1YLOXrL41-v7BNJej-QrkKPkamU","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FF7B72\">export\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> VISIONSTORY_API_KEY\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"sk-vs-xxxxxxxxxxxxxxxxxxx\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">curl\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -LsSf\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\"> |\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> sh\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">uvx\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> --refresh\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> visionstory-mcp\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> --check\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"mcpServers\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">    \"visionstory\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">      \"command\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"uvx\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">      \"args\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: [\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"visionstory-mcp\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">],\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">      \"env\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: { \u003C\u002Fspan>\u003Cspan style=\"color:#7EE787\">\"VISIONSTORY_API_KEY\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"YOUR_LOCAL_VISIONSTORY_API_KEY\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">python3\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -m\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> pip\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> install\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> --upgrade\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> visionstory-mcp\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">\"command\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"visionstory-mcp\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">\"args\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: []\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"mcpServers\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">    \"visionstory-remote\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">      \"url\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"https:\u002F\u002FYOUR_MCP_HOST\u002Fmcp\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">      \"headers\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">        \"Authorization\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"Bearer YOUR_LOCAL_VISIONSTORY_API_KEY\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">      }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FF7B72\">from\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> visionstory \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> VisionStoryClient, build_video_payload\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">client \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> VisionStoryClient.from_env()   \u003C\u002Fspan>\u003Cspan style=\"color:#8B949E\"># reads VISIONSTORY_API_KEY\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">video \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> client.generate_video(build_video_payload(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">    avatar_id\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"YOUR_AVATAR_ID\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">text\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"Hello from VisionStory.\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">voice_id\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"YOUR_VOICE_ID\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">))\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">npx\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> skills\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> add\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> visionstory-ai\u002Fskills\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> --skill\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> visionstory-api\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">git\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> clone\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> https:\u002F\u002Fgithub.com\u002Fvisionstory-ai\u002Fskills.git\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">mkdir\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -p\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> .agents\u002Fskills\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">cp\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -r\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> skills\u002Fvisionstory-api\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> .agents\u002Fskills\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">python3\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> .agents\u002Fskills\u002Fvisionstory-api\u002Fscripts\u002Fvisionstory_api.py\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> models\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">python3\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> .agents\u002Fskills\u002Fvisionstory-api\u002Fscripts\u002Fvisionstory_api.py\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> create-video\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> --avatar-id\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> YOUR_AVATAR_ID\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> --text\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \"Hello from VisionStory.\"\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> --voice-id\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> YOUR_VOICE_ID\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> --output\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> result.mp4\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan>Read https:\u002F\u002Fdevelopers.visionstory.ai\u002Fllms.txt for the VisionStory API docs index.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>Append .md to any guide URL to get that guide as Markdown.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>Load the one guide that matches the task, then use OpenAPI for exact fields.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>Use https:\u002F\u002Fdevelopers.visionstory.ai\u002Fllms-full.txt only when the task spans several capabilities.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>Use https:\u002F\u002Fdevelopers.visionstory.ai\u002Fopenapi.json for the complete machine-readable API contract.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1788547143929]