{"server":"gemini-hut-ag","mcp_endpoint":"https://gemini-hut.vyibc.com/ag/mcp","page":"https://ag.vyibc.com/","lab":"https://gemini-hut.vyibc.com/ag","count":21,"groups":[{"id":"replica","title":"视频复刻","desc":"任意公网视频 → 可复刻方案 → 评测迭代","tools":["ag_douyin_reverse","ag_douyin_review","ag_douyin_job"]},{"id":"review","title":"评测","desc":"给生成视频打分：哪里坏了、要不要重来、提示词怎么改","tools":["ag_video_quality"]},{"id":"gen","title":"生成","desc":"文本、图片、分镜帧、视频提示词","tools":["ag_generate","ag_generate_image","ag_storyboard_frames","ag_video_prompt"]},{"id":"understand","title":"理解","desc":"看图 / 看视频 / 听音频 / 专业拉片","tools":["ag_understand_media","ag_video_breakdown"]},{"id":"web","title":"搜索与网页","desc":"联网回答、深度调研、抓网页、查网址","tools":["ag_search_answer","ag_fetch_url","ag_check_url","ag_deep_research"]},{"id":"chat","title":"对话","desc":"多轮对话与会话管理","tools":["ag_chat","ag_conversations"]},{"id":"util","title":"辅助","desc":"函数调用、素材上传、模型、token、号池","tools":["ag_call_functions","ag_list_models","ag_pool_status","ag_count_tokens","ag_put_media"]}],"tools":[{"name":"ag_douyin_reverse","description":"视频复刻：反推任意短视频的复刻方案（异步，立即返回 job_id，用 ag_douyin_job 查）。名字里的 douyin 是历史原因，来源不限：抖音、快手、小红书、YouTube、自己拍的都行。输入任意公网可直接下载的 https mp4（≤60s、≤100MB）；本工具不解析分享链接，需先由调用方用解析工具（如 vyibc-douyin，可选）拿到直链或自行上传。流程：Media Transformations 抽帧测硬切 → Gemini 拉片分段（按硬切，每段 ≤8s，长镜头在动作停顿处切）→ 每段生成关键帧分镜图 + 首帧 + 尾帧（gemini-3.1-flash-image）+ Flow / Muse 两套提示词（结构化字段 + 可直接粘贴的完整提示词）+ 推荐（中文台词或需锁首尾帧 → Flow，否则 Muse）+ 可直接传给 vyibc-video generate_video 的参数。没给角色参考图时，会先生成一张「像原主角但不是同一个人」的角色设定图，所有分镜都用它。图片在 resource.vyibc.com，保留 30 天。56s 视频约 10–20 分钟。","inputSchema":{"type":"object","properties":{"video_url":{"type":"string","description":"必填。公网可直接下载的 mp4 直链（https），任意来源：抖音/快手/小红书/YouTube 解析出的直链、对象存储、resource.vyibc.com 等"},"douyin_url":{"type":"string","description":"可选，原视频页面链接（任意平台），只做标注，不会去解析或下载"},"muse_parse":{"type":"object","description":"可选，来源解析结果（任意解析器给的标题/作者/文案/台词，有就当底稿：台词校对、文案）","properties":{"title":{"type":"string"},"author":{"type":"string"},"copy":{"type":"string"},"transcript":{"type":"string"}}},"reference_images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"https 图片链接（会转存到 resource.vyibc.com，供 Muse / Flow 直接引用）"},"role":{"type":"string","enum":["character","product","scene","style"],"description":"character=替换主角用的人物；product=必须原样出现的商品；scene=场景；style=画风"},"name":{"type":"string"},"note":{"type":"string"}},"required":["url","role"]},"maxItems":4,"description":"可选参考图（≤4），每张标 role。给了 character 就不生成角色设定图"},"storyboard_layout":{"type":"string","enum":["auto","single","2","4","6","9","frames"],"description":"关键帧分镜图版式：auto（按段长 2/4/6 格，默认）、single（1 张）、2/4/6/9 格、frames（不出分镜图，只出首尾帧）"},"target":{"type":"string","enum":["both","flow","muse"],"description":"默认 both：两套提示词都给并按规则推荐；flow / muse 只输出该平台"},"language":{"type":"string","enum":["en","zh"],"description":"提示词语言，默认 en（每段另附中文说明 note_zh）"},"image_size":{"type":"string","enum":["1K","2K","4K"],"description":"分镜图 / 首尾帧 / 角色图分辨率，默认 2K（9:16 约 1536×2752）；4K 更慢"}},"required":["video_url"]},"annotations":null,"tested":true,"title":"视频复刻 · 拆解","group":"replica","blurb":"任意公网 mp4 → 分段、分镜图、首尾帧、Flow / Muse 提示词","example":{"video_url":"https://ag.vyibc.com/ag-assets/samples/vr/orig-640.mp4","storyboard_layout":"auto","target":"both","language":"zh","image_size":"1K"},"primary":["video_url","reference_images","storyboard_layout","target","language","image_size"],"result":"job","cost":"high","eta":"异步 10–20 分钟","output":"立即返回 { job_id, status, expires_at }；用 ag_douyin_job 查进度，完成后 action=result 取完整方案（segments、分镜图 url、提示词、vyibc-video 参数）。","notes":["来源不限：抖音 / 快手 / 小红书 / YouTube 解析出的直链或自己上传的 mp4 都行；本工具不解析分享链接。","≤60 秒、≤100MB；56 秒视频约 10–20 分钟，会生成十几到几十张图。","没给 character 参考图时先生成一张「像原主角但不是同一人」的角色设定图。","结果保留 30 天，只有发起人能查。"],"confirm":"这会启动一次完整复刻任务（约 10–20 分钟，出十几张图）。确定运行？"},{"name":"ag_douyin_review","description":"视频复刻评测：复盘生成视频（异步，立即返回 job_id）。适用于任意来源的参考片（不限抖音）和任意生成器（Flow / Muse / Grok 等）产出的视频。参考片 vs 生成片逐段 7 维打分（构图景别 / 主体一致性 / 动作节奏时长 / 运镜 / 光色 / 台词口型（有台词才评）/ 瑕疵），每个问题带时间点和导致它的提示词原句；每段给 保留 / 重做、改进建议、改写后的提示词；重做段重新生成关键帧分镜图和首尾帧。给 reverse_id 时自动取当时的分段、提示词、分镜图和角色图。","inputSchema":{"type":"object","properties":{"reverse_id":{"type":"string","description":"ag_douyin_reverse 的 job_id（推荐）。自动对齐分段和提示词"},"reference_video_url":{"type":"string","description":"参考片 mp4（任意来源的公网 https 直链）；给了 reverse_id 可省略"},"generated_video_url":{"type":"string","description":"生成的整片 mp4（按时长比例切成对应段）。与 segments 二选一"},"segments":{"type":"array","description":"分段生成的视频。index 对应 reverse 的段号（从 1 开始）","items":{"type":"object","properties":{"index":{"type":"integer"},"video_url":{"type":"string"},"prompt":{"type":"string","description":"生成时实际用的提示词（不给就用 reverse 里推荐平台的提示词）"},"ref_start":{"type":"number","description":"没有 reverse_id 时：对应参考片的起点秒"},"ref_end":{"type":"number"}},"required":["index","video_url"]}},"prompts":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"prompt":{"type":"string"}},"required":["index","prompt"]},"description":"整片模式下各段实际用的提示词"},"used_target":{"type":"string","enum":["flow","muse"],"description":"生成时用的平台（从 reverse 取提示词时用），默认取每段推荐"},"language":{"type":"string","enum":["en","zh"],"description":"改写提示词语言，默认 en"},"image_size":{"type":"string","enum":["1K","2K","4K"],"description":"重做段新分镜图分辨率，默认 2K"},"storyboard_layout":{"type":"string","enum":["auto","single","2","4","6","9","frames"],"description":"重做段分镜图版式，默认 auto"}}},"annotations":null,"tested":true,"title":"复刻评测","group":"replica","blurb":"参考片 vs 生成片逐段 7 维打分，重做段给新提示词和分镜图","example":{"reverse_id":"","generated_video_url":"","language":"zh","image_size":"1K"},"primary":["reverse_id","generated_video_url","segments","reference_video_url","language"],"result":"job","cost":"high","eta":"异步 5–15 分钟","output":"立即返回 { job_id }；结果含每段 7 维评分、问题时间点、保留 / 重做、改写提示词和新分镜图。","notes":["推荐给 reverse_id（自动对齐分段和提示词）；没有就给 reference_video_url + 生成片。","生成片可来自 Flow / Muse / Grok 等任意生成器。"],"confirm":"这会启动一次评测任务（几分钟到十几分钟，重做段会重新出图）。确定运行？"},{"name":"ag_douyin_job","description":"查异步任务（ag_douyin_reverse / ag_douyin_review / ag_video_quality）。action=status：阶段、进度、各步耗时；action=result：完整结果（未完成时返回状态）。结果保留 30 天，只能查自己 Key 建的任务。","inputSchema":{"type":"object","properties":{"job_id":{"type":"string"},"action":{"type":"string","enum":["status","result"],"description":"默认 status"}},"required":["job_id"]},"annotations":{"readOnlyHint":true},"tested":true,"title":"复刻任务进度 / 结果","group":"replica","blurb":"查拆解 / 评测任务的阶段、进度、耗时和完整结果","example":{"job_id":"","action":"status"},"primary":["job_id","action"],"result":"job","cost":"free","eta":"即时","output":"status：{ status, stage, progress, timings_ms }；result：再加 result（完整方案）。","notes":["只能查自己发起的任务（网页登录和 vgl_ Key 各自隔离）。","页面会自动带上你最近一次拆解 / 评测的 job_id。"],"confirm":null},{"name":"ag_video_quality","description":"生成视频质量评测：只看这条生成视频本身做得好不好（不需要原视频）。输入生成片 + 生成时用的提示词 + 参考图（选填），输出总分（1–5）、各维度分和理由（贴合提示词 / 人物与参考图一致 / 画面质量（清晰度、伪影、闪烁）/ 动作自然与物理 / 穿帮瑕疵（手指变形、脸漂、乱码字、物体变形）/ 声音台词口型（有声才评）/ 构图运镜），带起止秒和严重度的问题清单、判定（保留 / 小修 / 重生成）、改进建议和按目标模型改写的提示词。给 source_video_url 时额外评「与原视频相似度」（不计入总分）。要和原片逐段对比复刻效果请用 ag_douyin_review。默认异步返回 job_id（用 ag_douyin_job 查）；async=false 同步等结果（实测 5–6 秒的片约 20–45 秒）。","inputSchema":{"type":"object","properties":{"video_url":{"type":"string","description":"生成的视频 mp4（公网 https 直链，≤60s、≤100MB）"},"prompt":{"type":"string","description":"生成这条视频时实际用的提示词（原文）"},"reference_images":{"type":"array","description":"生成时用的参考图（≤4 张）。有 character 时按它评人物一致性","items":{"type":"object","properties":{"url":{"type":"string"},"role":{"type":"string","enum":["character","scene","first_frame","last_frame","product","style","other"]},"name":{"type":"string"}},"required":["url","role"]}},"source_video_url":{"type":"string","description":"选填：要复刻的原视频 mp4（https）。给了才额外评相似度"},"language":{"type":"string","enum":["en","zh"],"description":"修正关键帧提示词的语言，默认 en；改写提示词跟随原 prompt 的语言，评语始终中文"},"focus":{"type":"string","description":"选填：特别关注点，如「手部」「台词口型」「商品不能变形」"},"target_model":{"type":"string","enum":["muse","flow","grok","other"],"description":"改写提示词面向的生成器：muse / flow / grok / other，默认 other"},"suggest_keyframe":{"type":"boolean","description":"判定为重生成时，按改写后的提示词再出 1 张修正关键帧（多一次生图），默认 false"},"image_size":{"type":"string","enum":["1K","2K"],"description":"修正关键帧分辨率，默认 1K"},"async":{"type":"boolean","description":"默认 true：立即返回 job_id；false：同步等待结果"}},"required":["video_url","prompt"]},"annotations":null,"tested":true,"title":"生成视频质量评测","group":"review","blurb":"只看生成片本身：7 维打分 + 带时间的问题 + 保留 / 小修 / 重生成 + 改写提示词","example":{"video_url":"https://ag.vyibc.com/ag-assets/samples/vr/gen-store.mp4","prompt":"16:9, 5 seconds. Boyfriend-POV couple vlog in a small seaside-town convenience store, summer afternoon. An adult, sweet, baby-faced young woman with long dark hair and a white ribbon, wearing a mint knit cardigan over a white top and a white midi skirt, stands in front of the drinks fridge holding two bottles (a green lime soda and a pink peach soda) up toward the camera, smiling, and asks in Mandarin: “喝哪个？青柠还是桃子？”. Handheld phone camera at eye level, slight natural shake, warm soft daylight from the shop window, realistic skin, natural lip sync.","reference_images":[{"url":"https://ag.vyibc.com/ag-assets/samples/vr/char-v4.jpg","role":"character","name":"薄荷开衫女孩 v4"}],"language":"zh","target_model":"grok","async":false},"primary":["video_url","prompt","reference_images","source_video_url","target_model","language","focus","async"],"result":"quality","cost":"mid","eta":"约 20–45 秒（默认异步）","output":"{ overall_score, mean_score, verdict（keep/minor_fix/regenerate）, verdict_label, dimensions[{id,label,score,reason_zh}], issues[{start,end,severity,dimension,description_zh,prompt_cause,fix_zh}], suggestions_zh, revised_prompt{…full_prompt}, source_similarity?, keyframe? }；async=true（默认）时先返回 { job_id }，用 ag_douyin_job 取结果。","notes":["和「复刻评测」的区别：这里不需要原片，只判断这条生成视频本身好不好；要和原片逐段对比用 ag_douyin_review。","给 source_video_url 时额外评「与原视频相似度」，单独展示，不计入总分和判定。","判定规则：任一维度 ≤2 分或有严重问题 → 重生成；有 3 分或明显问题 → 小修；服务端只会判得比模型更严。无声片不评声音维度。","target_model 决定改写提示词的写法（Grok 一段话 ≤900 字符；Muse 写明画幅和秒数、不用首尾帧；Flow 4/6/8 秒、台词带引号）。","suggest_keyframe=true 且判定为重生成时才多出 1 张修正关键帧（1K），默认关。","实测（2026-10-31，Grok 5–6 秒 720p 片）：同步约 21 秒、异步任务 33–44 秒拿到结果（评测 20–26 秒；带 28 秒原片多 5–7 秒探测）；≤60s、≤100MB。"],"confirm":null},{"name":"ag_generate","description":"通用 generateContent 透传（Gemini 原生格式）。strict=true（默认）时拒绝实测 400 的参数（presence/frequencyPenalty、candidateCount>1、urlContext、codeExecution、googleSearch+functionDeclarations 同用、未知模型），剥掉实测无效的参数并在 warnings 说明。parts 里可写 {media: MediaRef}。生成的图片自动存 R2 并返回 artifacts。","inputSchema":{"type":"object","properties":{"model":{"type":"string","description":"默认 gemini-3.8-flash-medium；responseModalities 含 IMAGE 时默认 gemini-3.1-flash-image"},"contents":{"type":"array","items":{"type":"object"},"description":"Gemini contents：[{role:user|model, parts:[{text}|{media:MediaRef}|{inlineData}|{fileData}|{functionCall}|{functionResponse}]}]"},"systemInstruction":{"description":"字符串或 {parts:[{text}]}"},"generationConfig":{"type":"object","description":"支持 responseMimeType, responseSchema, maxOutputTokens, stopSequences, seed, thinkingConfig, mediaResolution, responseModalities, imageConfig, temperature/topP/topK（效果弱）"},"tools":{"type":"array","items":{"type":"object"},"description":"只支持 [{googleSearch:{}}] 或 [{functionDeclarations:[…]}]（两者不能同用）"},"strict":{"type":"boolean","description":"默认 true"},"return_thoughts":{"type":"boolean"},"include_raw":{"type":"boolean"}},"required":["contents"]},"annotations":null,"tested":true,"title":"文本生成（原生透传）","group":"gen","blurb":"Gemini 原生 generateContent，严格模式拦掉实测无效参数","example":{"contents":[{"role":"user","parts":[{"text":"用三句话介绍「视频复刻」能帮短视频创作者做什么。"}]}]},"primary":["contents","model","systemInstruction","generationConfig"],"result":"text","cost":"low","eta":"2–10 秒","output":"{ text, artifacts?, meta: { model, modelVersion, usage }, warnings }","notes":["默认 gemini-3.8-flash-medium；strict=true 时 presence/frequencyPenalty、candidateCount>1 等会直接报错而不是静默忽略。","parts 里可写 {media:{url|artifact_id}} 引用图片 / 视频。"],"confirm":null},{"name":"ag_generate_image","description":"文生图 / 参考图生图（gemini-3.1-flash-image）。14 种画幅 + auto，512/1K/2K/4K，≤3 张参考图，n≤4（2 并发）。图片存 resource.vyibc.com（30 天），返回 artifacts（id/url/宽高）。","inputSchema":{"type":"object","properties":{"prompt":{"type":"string"},"aspect_ratio":{"type":"string","enum":["16:9","1:1","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9","4:1","1:4","8:1","1:8","auto"]},"image_size":{"type":"string","enum":["512","1K","2K","4K"],"description":"默认 1K；4K 约 5–6K×3K、更慢"},"n":{"type":"integer","minimum":1,"maximum":4},"seed":{"type":"integer"},"reference_images":{"type":"array","items":{"type":"object","description":"媒体引用：url（https，图片/视频/音频/YouTube）、base64+mime、或 artifact_id（本 MCP 之前产出的 a_…）三选一","properties":{"url":{"type":"string"},"base64":{"type":"string"},"mime":{"type":"string"},"artifact_id":{"type":"string"},"label":{"type":"string"},"role":{"type":"string"}}},"maxItems":3},"reference_instructions":{"type":"string","description":"说明每张参考图怎么用"},"style":{"type":"string"},"negative":{"type":"string"},"return_text":{"type":"boolean"}},"required":["prompt"]},"annotations":null,"tested":true,"title":"生图 / 参考图改图","group":"gen","blurb":"14 种画幅 + auto，512–4K，≤3 张参考图，一次 ≤4 张","example":{"prompt":"9:16 动漫角色设定图：银紫长发少女，白色短夹克，薰衣草花园背景，干净柔光","aspect_ratio":"9:16","image_size":"1K","n":1},"primary":["prompt","aspect_ratio","image_size","reference_images","n"],"result":"images","cost":"mid","eta":"10–30 秒 / 张","output":"{ artifacts: [{ id, url, width, height, prompt_used }], meta: { model, image_size, aspect_ratio } }；图片在 resource.vyibc.com，保留 30 天。","notes":["模型 gemini-3.1-flash-image；n>1 时 2 并发。","4K 约 5–6K×3K，明显更慢。","参考图用 url / base64 / artifact_id 三选一。"],"confirm":null},{"name":"ag_storyboard_frames","description":"按关键帧批量出分镜图（gemini-3.1-flash-image，≤12 格，2 并发）。每格参考图顺序：角色图 → 原视频关键帧（复制机位构图）→ 额外参考，合计 ≤3。返回每格 artifact + prompt_used，失败格可单独重跑。","inputSchema":{"type":"object","properties":{"character_refs":{"type":"array","items":{"type":"object","description":"媒体引用：url（https，图片/视频/音频/YouTube）、base64+mime、或 artifact_id（本 MCP 之前产出的 a_…）三选一","properties":{"url":{"type":"string"},"base64":{"type":"string"},"mime":{"type":"string"},"artifact_id":{"type":"string"},"label":{"type":"string"},"role":{"type":"string"}}},"maxItems":2},"character_desc":{"type":"string"},"outfits":{"type":"object","description":"{名字: 服装描述}，frame.outfit 引用"},"style":{"type":"string"},"negative":{"type":"string"},"frames":{"type":"array","minItems":1,"maxItems":12,"items":{"type":"object","properties":{"id":{"type":"string"},"time":{"type":"number"},"seg":{"type":"integer"},"source_frame":{"type":"object","description":"媒体引用：url（https，图片/视频/音频/YouTube）、base64+mime、或 artifact_id（本 MCP 之前产出的 a_…）三选一","properties":{"url":{"type":"string"},"base64":{"type":"string"},"mime":{"type":"string"},"artifact_id":{"type":"string"},"label":{"type":"string"},"role":{"type":"string"}}},"shot":{"type":"string"},"outfit":{"type":"string"},"include_character":{"type":"boolean","description":"false=空镜"},"extra_refs":{"type":"array","items":{"type":"object","description":"媒体引用：url（https，图片/视频/音频/YouTube）、base64+mime、或 artifact_id（本 MCP 之前产出的 a_…）三选一","properties":{"url":{"type":"string"},"base64":{"type":"string"},"mime":{"type":"string"},"artifact_id":{"type":"string"},"label":{"type":"string"},"role":{"type":"string"}}}},"prompt_override":{"type":"string"}}}},"from_breakdown":{"type":"object","description":"ag_video_breakdown 的 json；frame 没写 shot 时按 time 取对应段描述"},"aspect_ratio":{"type":"string","enum":["16:9","1:1","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9","4:1","1:4","8:1","1:8","auto"]},"image_size":{"type":"string","enum":["512","1K","2K","4K"]},"concurrency":{"type":"integer","minimum":1,"maximum":2}},"required":["frames"]},"annotations":null,"tested":true,"title":"批量分镜帧","group":"gen","blurb":"≤12 帧、2 并发；参考图按 角色 → 原关键帧 → 其它 排序","example":{"character_refs":[{"url":"https://ag.vyibc.com/ag-assets/samples/vr/char.jpg"}],"frames":[{"id":"K1","source_frame":{"url":"https://ag.vyibc.com/ag-assets/samples/vr/oK1.jpg"},"shot":"天台中央全景，少女展开双臂蓄势站立"}],"aspect_ratio":"9:16","image_size":"1K"},"primary":["frames","character_refs","character_desc","aspect_ratio","image_size"],"result":"frames","cost":"mid","eta":"每格 10–30 秒","output":"{ frames: [{ id, artifact: { url }, prompt_used, error? }], stats: { total, failed } }","notes":["每格参考图合计 ≤3：角色图 → 原视频关键帧（复制机位构图）→ 额外参考。","失败格可只把那几格再跑一次。"],"confirm":null},{"name":"ag_video_prompt","description":"根据拉片 + 分镜图写视频生成提示词，并给出可传给 vyibc-video generate_video 的参数（本工具不调用生成）。按硬切点分段，不把换装/换景放进同一段。每段时长用 target.duration_seconds（4/6/8）；不传时按源片总长推断（≤8s 取刚好装得下的 4/6/8），否则 8。返回的 range 是源片时间，clip_seconds 是生成时长。","inputSchema":{"type":"object","properties":{"breakdown":{"type":"object"},"description":{"type":"string"},"storyboard":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"time":{"type":"number"},"prompt_used":{"type":"string"}},"required":["id","url"]}},"attach_storyboard_images":{"type":"boolean","description":"默认 true（≤12 张给模型看）"},"target":{"type":"object","properties":{"provider":{"type":"string","enum":["flow","gemini"]},"mode":{"type":"string","enum":["frames","references","image","text"]},"duration_seconds":{"type":"integer","enum":[4,6,8],"description":"每段生成时长；不传按源片总长推断"},"aspect_ratio":{"type":"string","enum":["9:16","16:9"]}}},"segmentation":{"type":"string","enum":["auto","whole","per_shot"]},"timeline_scale":{"type":"string","enum":["fit","absolute"]},"character_desc":{"type":"string"},"outfits":{"type":"object"},"style":{"type":"string"},"include":{"type":"object"},"max_prompt_chars":{"type":"integer"},"model":{"type":"string","description":"模型；只接受该能力实测通过的模型（见 ag_list_models），默认 gemini-3.8-flash-high"}}},"annotations":null,"tested":true,"title":"视频提示词","group":"gen","blurb":"按拉片 + 分镜写 Flow / Gemini 视频提示词，可选 4/6/8 秒","example":{"description":"6 秒竖屏短视频：天台上银紫长发少女展开双臂蓄力，旋身甩发，镜头环绕推进，阳光明亮。","target":{"provider":"flow","mode":"text","duration_seconds":6,"aspect_ratio":"9:16"}},"primary":["description","breakdown","storyboard","target"],"result":"segments","cost":"low","eta":"10–40 秒","output":"{ segments: [{ index, range, clip_seconds, prompt_en, prompt_zh }], whole_prompt_en, vyibc_video_calls: [...] }","notes":["本工具只写参数，不调用视频生成；vyibc_video_calls 可直接复制给 vyibc-video。","不传 duration_seconds 时按源片总长推断（≤8 秒取 4/6/8），否则 8 秒。"],"confirm":null},{"name":"ag_understand_media","description":"看图 / 看视频 / 听音频 / 读 YouTube。preset: describe/compare/timeline/transcribe/ocr/qa/custom。按媒体类型自动选实测通过的模型（音频默认 gemini-3-flash）。","inputSchema":{"type":"object","properties":{"media":{"type":"array","items":{"type":"object","description":"媒体引用：url（https，图片/视频/音频/YouTube）、base64+mime、或 artifact_id（本 MCP 之前产出的 a_…）三选一","properties":{"url":{"type":"string"},"base64":{"type":"string"},"mime":{"type":"string"},"artifact_id":{"type":"string"},"label":{"type":"string"},"role":{"type":"string"}}},"minItems":1,"maxItems":16},"preset":{"type":"string","enum":["describe","compare","timeline","transcribe","ocr","qa","custom"]},"prompt":{"type":"string"},"system":{"type":"string"},"language":{"type":"string","enum":["zh","en"]},"output_schema":{"type":"object","description":"JSON 结构化输出的 schema（Gemini OpenAPI 子集；Claude 写进提示词）"},"media_resolution":{"type":"string","enum":["low","medium","high"]},"thinking":{"type":"string","enum":["off","low","high"],"description":"思考强度（gemini-3 系映射 thinkingLevel，2.5 系映射 budget）"},"return_thoughts":{"type":"boolean"},"max_output_tokens":{"type":"integer","description":"回答正文的大致预算（不含思考；服务端另留思考额度，被截断时自动放大重试一次，仍截断会返回 truncated=true）"},"seed":{"type":"integer"},"model":{"type":"string","description":"模型；只接受该能力实测通过的模型（见 ag_list_models），默认 按媒体类型"}},"required":["media"]},"annotations":null,"tested":true,"title":"看图 / 看视频 / 听音频","group":"understand","blurb":"describe / compare / timeline / transcribe / ocr / qa，按媒体自动选模型","example":{"media":[{"url":"https://ag.vyibc.com/ag-assets/samples/vr/char.jpg"}],"preset":"describe","language":"zh"},"primary":["media","preset","prompt","language"],"result":"text","cost":"low","eta":"3–30 秒","output":"{ text, json?（给 output_schema 时）, truncated, meta, warnings }","notes":["音频默认 gemini-3-flash；外链抓不到时服务端会转存再试。","被截断时自动放大预算重试一次，仍截断会标 truncated=true。"],"confirm":null},{"name":"ag_video_breakdown","description":"专业拉片。mode=baseline（默认，公网 MP4 自动测量时长和硬切点作为客观底稿；准确率远高于 pure）/pure。preset=pro（21 字段）/shots（简表）/custom(fields)。返回 json + markdown 表 + measured。","inputSchema":{"type":"object","properties":{"video":{"type":"object","description":"媒体引用：url（https，图片/视频/音频/YouTube）、base64+mime、或 artifact_id（本 MCP 之前产出的 a_…）三选一","properties":{"url":{"type":"string"},"base64":{"type":"string"},"mime":{"type":"string"},"artifact_id":{"type":"string"},"label":{"type":"string"},"role":{"type":"string"}}},"mode":{"type":"string","enum":["baseline","pure"]},"baseline":{"type":"object","description":"调用方自带客观底稿：{duration, cut_points[], beats?, bpm?, asr?, grid_image?:MediaRef}；不给则自动测量"},"preset":{"type":"string","enum":["pro","shots","custom"]},"fields":{"type":"array","items":{"type":"string"}},"segment_seconds":{"type":"array","items":{"type":"number"},"description":"[最短, 最长]，默认 [0.5, 2]"},"time_precision":{"type":"number"},"include":{"type":"object","properties":{"rhythm_curve":{"type":"boolean"},"visual_style":{"type":"boolean"},"audio_visual":{"type":"boolean"},"uncertain":{"type":"boolean"}}},"output_schema":{"type":"object","description":"JSON 结构化输出的 schema（Gemini OpenAPI 子集；Claude 写进提示词）"},"language":{"type":"string","enum":["zh","en"]},"media_resolution":{"type":"string","enum":["low","medium","high"]},"model":{"type":"string","description":"模型；只接受该能力实测通过的模型（见 ag_list_models），默认 gemini-3.8-flash-high"}},"required":["video"]},"annotations":null,"tested":true,"title":"专业拉片","group":"understand","blurb":"自动测时长和硬切点做底稿，21 字段 / 简表 / 自定义字段","example":{"video":{"url":"https://ag.vyibc.com/ag-assets/samples/vr/orig-640.mp4"},"preset":"shots","language":"zh"},"primary":["video","preset","mode","language"],"result":"table","cost":"mid","eta":"30–90 秒","output":"{ json, markdown（表格）, measured: { duration, cut_points }, baseline_used, meta }","notes":["mode=baseline（默认）准确率远高于 pure。","公网 mp4 自动测量；也可自带 baseline 底稿。"],"confirm":null},{"name":"ag_search_answer","description":"联网搜索后回答（googleSearch grounding），返回 text + sources[] + citations[]（文本区间→来源）+ queries。","inputSchema":{"type":"object","properties":{"query":{"type":"string"},"answer_style":{"type":"string","enum":["brief","detailed","bullets"]},"language":{"type":"string","enum":["zh","en"]},"system":{"type":"string"},"thinking":{"type":"string","enum":["off","low","high"],"description":"思考强度（gemini-3 系映射 thinkingLevel，2.5 系映射 budget）"},"max_output_tokens":{"type":"integer"},"model":{"type":"string","description":"模型；只接受该能力实测通过的模型（见 ag_list_models），默认 gemini-3.8-flash-medium"}},"required":["query"]},"annotations":null,"tested":true,"title":"联网搜索回答","group":"web","blurb":"googleSearch grounding，回答 + 来源 + 引用区间","example":{"query":"Cloudflare Workers 免费版每天能处理多少请求？","answer_style":"brief","language":"zh"},"primary":["query","answer_style","language"],"result":"sources","cost":"low","eta":"5–15 秒","output":"{ text, sources: [{ title, uri }], citations, queries }","notes":["来源链接是 Google 跳转地址，点开会落到原站。"],"confirm":null},{"name":"ag_fetch_url","description":"抓取网页原文（AG fetchUrl）。extract=text（默认，去标签）/raw/title。","inputSchema":{"type":"object","properties":{"url":{"type":"string"},"live":{"type":"boolean","description":"默认 true（实时抓）"},"extract":{"type":"string","enum":["text","raw","title"]},"max_bytes":{"type":"integer"}},"required":["url"]},"annotations":{"readOnlyHint":true},"tested":true,"title":"抓取网页原文","group":"web","blurb":"AG fetchUrl：text（去标签）/ raw / title","example":{"url":"https://example.com","extract":"text"},"primary":["url","extract","max_bytes"],"result":"page","cost":"free","eta":"1–5 秒","output":"{ url, title, bytes, content, truncated }","notes":["部分站点会拦截抓取，返回空正文时 warnings 会说明。"],"confirm":null},{"name":"ag_check_url","description":"网址安全检查（AG checkUrl），1–10 个，返回每个的 verdict。","inputSchema":{"type":"object","properties":{"url":{"type":"string"},"urls":{"type":"array","items":{"type":"string"},"maxItems":10}}},"annotations":{"readOnlyHint":true},"tested":true,"title":"网址安全检查","group":"web","blurb":"1–10 个网址，返回 clean / flagged / blocked","example":{"urls":["https://example.com","https://testsafebrowsing.appspot.com/s/malware.html"]},"primary":["urls","url"],"result":"verdicts","cost":"free","eta":"1–3 秒","output":"{ results: [{ url, verdict, list, enforcement }] }","notes":["testsafebrowsing 是 Google 官方测试网址，用来看「命中」长什么样。"],"confirm":null},{"name":"ag_deep_research","description":"深度调研（服务端编排）：拆子问题 → 每题联网搜索 → 抓高频来源原文 → 汇总成带 [n] 引用的报告。约 1–3 分钟。","inputSchema":{"type":"object","properties":{"question":{"type":"string"},"sub_questions":{"type":"integer","minimum":2,"maximum":6},"rounds":{"type":"integer","minimum":1,"maximum":2},"max_sources":{"type":"integer"},"fetch_pages":{"type":"integer","minimum":0,"maximum":8},"report":{"type":"string","enum":["brief","full","table"]},"output_schema":{"type":"object","description":"JSON 结构化输出的 schema（Gemini OpenAPI 子集；Claude 写进提示词）"},"language":{"type":"string","enum":["zh","en"]},"model":{"type":"string","description":"模型；只接受该能力实测通过的模型（见 ag_list_models），默认 gemini-3.8-flash-medium"},"synth_model":{"type":"string"}},"required":["question"]},"annotations":null,"tested":true,"title":"深度调研","group":"web","blurb":"拆子问题 → 搜索 → 抓原文 → 带 [n] 引用的报告","example":{"question":"2026 年短视频「AI 复刻」常见工作流有哪些？各自优缺点？","sub_questions":3,"rounds":1,"fetch_pages":2,"report":"brief","language":"zh"},"primary":["question","sub_questions","report","language"],"result":"report","cost":"mid","eta":"1–3 分钟","output":"{ report（markdown，带 [n]）, sources, sub_questions, stats }","notes":["同步返回，约 1–3 分钟，期间别关页面。","fetch_pages 越多越慢但引用越扎实。"],"confirm":"深度调研约 1–3 分钟，期间请保持页面打开。确定运行？"},{"name":"ag_chat","description":"对话。无状态：messages[{role,text}]（最后一条为 user）。会话：message（单给 message 或 new_conversation=true 即新建会话；带 conversation_id 续聊），服务端保存历史（30 天），可 fork_from_turn 分叉。支持 media、output_schema（返回 json）/output_enum（返回 value）、thinking、seed、stop。","inputSchema":{"type":"object","properties":{"messages":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string","enum":["user","model"]},"text":{"type":"string"}},"required":["text"]}},"message":{"type":"string"},"conversation_id":{"type":"string"},"new_conversation":{"type":"boolean"},"fork_from_turn":{"type":"integer"},"media":{"type":"array","items":{"type":"object","description":"媒体引用：url（https，图片/视频/音频/YouTube）、base64+mime、或 artifact_id（本 MCP 之前产出的 a_…）三选一","properties":{"url":{"type":"string"},"base64":{"type":"string"},"mime":{"type":"string"},"artifact_id":{"type":"string"},"label":{"type":"string"},"role":{"type":"string"}}},"maxItems":8},"system":{"type":"string"},"output_schema":{"type":"object","description":"JSON 结构化输出的 schema（Gemini OpenAPI 子集；Claude 写进提示词）"},"output_enum":{"type":"array","items":{"type":"string"}},"thinking":{"type":"string","enum":["off","low","high"],"description":"思考强度（gemini-3 系映射 thinkingLevel，2.5 系映射 budget）"},"thinking_budget":{"type":"integer","description":"只对 gemini-2.5 系"},"return_thoughts":{"type":"boolean"},"max_output_tokens":{"type":"integer"},"stop":{"type":"array","items":{"type":"string"},"maxItems":5},"seed":{"type":"integer"},"history_policy":{"type":"string","enum":["truncate","full"]},"max_history_tokens":{"type":"integer"},"model":{"type":"string","description":"模型；只接受该能力实测通过的模型（见 ag_list_models），默认 gemini-3.8-flash-medium"}}},"annotations":null,"tested":true,"title":"多轮对话","group":"chat","blurb":"无状态 messages，或服务端会话（续聊 / 分叉，保留 30 天）","example":{"message":"给我 3 个 15 秒短视频选题，主题是城市夜跑。","new_conversation":true},"primary":["message","conversation_id","new_conversation","media","system"],"result":"chat","cost":"low","eta":"2–10 秒","output":"{ text, conversation_id?, turn?, meta, warnings }","notes":["结果里有 conversation_id 时，页面会提示一键续聊。","会话归属当前登录身份。"],"confirm":null},{"name":"ag_conversations","description":"管理 ag_chat 会话：action=list（自己 Key 的会话）/get（完整历史）/delete。","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","get","delete"]},"conversation_id":{"type":"string"},"limit":{"type":"integer"}}},"annotations":null,"tested":true,"title":"会话管理","group":"chat","blurb":"list / get / delete 自己的 ag_chat 会话","example":{"action":"list","limit":10},"primary":["action","conversation_id","limit"],"result":"list","cost":"free","eta":"即时","output":"list：{ conversations: [{ id, title, model, updated_at }] }；get：完整 turns。","notes":["只看得到当前登录身份建的会话。"],"confirm":null},{"name":"ag_call_functions","description":"函数调用（不执行，只返回模型要调的函数）。第一轮给 functions + messages；执行后把结果放进 function_results，并把返回的 model_turn 原样作为 previous_model_turn 再调一次拿最终回答。支持并行多调用。","inputSchema":{"type":"object","properties":{"functions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"parameters":{"type":"object"}},"required":["name"]}},"messages":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string","enum":["user","model"]},"text":{"type":"string"}},"required":["text"]}},"contents":{"type":"array","items":{"type":"object"},"description":"或直接给 Gemini contents"},"function_results":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"response":{"type":"object"}},"required":["name"]}},"previous_model_turn":{"type":"object"},"allowed_functions":{"type":"array","items":{"type":"string"},"description":"服务端过滤，只返回这些函数的调用"},"system":{"type":"string"},"model":{"type":"string","description":"模型；只接受该能力实测通过的模型（见 ag_list_models），默认 gemini-3.8-flash-medium"}},"required":["functions"]},"annotations":null,"tested":true,"title":"函数调用","group":"util","blurb":"只返回模型要调的函数（不执行），支持并行多调用","example":{"functions":[{"name":"get_weather","description":"查询城市今天的天气","parameters":{"type":"object","properties":{"city":{"type":"string"}},"required":["city"]}}],"messages":[{"role":"user","text":"上海和北京今天天气怎么样？"}]},"primary":["functions","messages","function_results","previous_model_turn"],"result":"functions","cost":"low","eta":"2–8 秒","output":"{ function_calls: [{ name, args }], text, model_turn, next }","notes":["执行完函数后把结果放 function_results，并把 model_turn 原样作为 previous_model_turn 再调一次拿最终回答。"],"confirm":null},{"name":"ag_list_models","description":"列出 AG 可用模型（按实测排名），可按能力过滤（text/vision/video/audio/func/search/json/think/image/breakdown）。","inputSchema":{"type":"object","properties":{"capability":{"type":"string","enum":["text","vision","vision_multi","video","video_local","audio","func","search","json","think","image","breakdown","all"]},"include_hidden":{"type":"boolean"},"limit":{"type":"integer"}}},"annotations":{"readOnlyHint":true},"tested":true,"title":"可用模型","group":"util","blurb":"按实测排名列模型，可按能力过滤","example":{"capability":"vision","limit":5},"primary":["capability","limit","include_hidden"],"result":"models","cost":"free","eta":"即时","output":"{ models: [{ id, rank, verified[], availability, default }] }","notes":["能力列只含实测可用模型；真实模型以响应 meta.modelVersion 为准。"],"confirm":null},{"name":"ag_pool_status","description":"号池状态（总数/可用/冷却/在途）与各模型剩余额度汇总，不含账号身份。","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true},"tested":true,"title":"号池状态","group":"util","blurb":"总数 / 可用 / 冷却 / 在途 + 各模型剩余额度，不含账号身份","example":{},"primary":[],"result":"pool","cost":"free","eta":"1–3 秒","output":"{ accounts_total, available, cooling, inflight, quota_summary: [{ model, remaining_fraction_min, reset_time }] }","notes":["不暴露任何账号身份。"],"confirm":null},{"name":"ag_count_tokens","description":"估算 token 数（text 或 Gemini contents）。","inputSchema":{"type":"object","properties":{"text":{"type":"string"},"contents":{"type":"array","items":{"type":"object"}},"model":{"type":"string"}}},"annotations":{"readOnlyHint":true},"tested":true,"title":"token 估算","group":"util","blurb":"估算一段文字或 contents 的 token 数","example":{"text":"AG 能力小窝：20 个工具，每个都能一键试跑。"},"primary":["text","contents","model"],"result":"tokens","cost":"free","eta":"即时","output":"{ model, totalTokens }","notes":["不消耗生成额度。"],"confirm":null},{"name":"ag_put_media","description":"把图片/视频/音频（base64 或 https url，≤50MB）存进 R2，返回 artifact_id + 公网 URL（resource.vyibc.com，30 天），供其它工具引用。","inputSchema":{"type":"object","properties":{"base64":{"type":"string"},"url":{"type":"string"},"mime":{"type":"string"}}},"annotations":null,"tested":true,"title":"上传素材","group":"util","blurb":"图片 / 视频 / 音频存进 R2，返回 artifact_id 给其它工具引用","example":{"url":"https://ag.vyibc.com/ag-assets/samples/vr/char.jpg"},"primary":["url","base64","mime"],"result":"artifact","cost":"free","eta":"1–5 秒","output":"{ artifact_id, url, bytes, mime, width?, height?, expires_in_days: 30 }","notes":["≤50MB；artifact_id 只能被同一身份引用。"],"confirm":null}]}