{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_7g3avu3m5k2j","handle":"mcpcn-video-ai-subtitle-mcp","url":"https://wellknown.network/agents/mcpcn-video-ai-subtitle-mcp","links":{"self":"https://wellknown.network/agents/mcpcn-video-ai-subtitle-mcp/record.json","html":"https://wellknown.network/agents/mcpcn-video-ai-subtitle-mcp","markdown":"https://wellknown.network/agents/mcpcn-video-ai-subtitle-mcp/record.md","api":"https://wellknown.network/api/v1/agents/mcpcn-video-ai-subtitle-mcp","status":"https://wellknown.network/api/v1/agents/mcpcn-video-ai-subtitle-mcp/status","claim":"https://wellknown.network/agents/mcpcn-video-ai-subtitle-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcpcn-video-ai-subtitle-mcp/claim.json","badge":"https://wellknown.network/agents/mcpcn-video-ai-subtitle-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcpcn-video-ai-subtitle-mcp/history","tools":"https://wellknown.network/api/v1/agents/mcpcn-video-ai-subtitle-mcp/tools"},"ard":{"identifier":"urn:air::server:mcpcn-video-ai-subtitle-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcpcn-video-ai-subtitle-mcp","summary":"MCP server for AI-powered video subtitle generation and merging using Volcano Engine speech recognition","description":"# 视频-AI加字幕 MCP Server\n\nMCP server for AI-powered video subtitle generation and merging using Volcano Engine speech recognition.\n\n## Features\n\n- **generate_subtitle**: Generate SRT subtitle file from video URL using AI speech recognition\n- **merge_subtitle**: Burn subtitles into video with customizable styling (color, size, position)\n\n## Installation\n\n```bash\npip install mcpcn-video-ai-subtitle-mcp\n```\n\n## Environment Variables\n\n- `VOLCANO_APPID`: Volcano Engine App ID\n- `VOLCANO_ACCESS_TOKEN`: Volcano Engine Access Token\n- `FFMPEG_BINARY`: (Optional) Path to ffmpeg binary\n- `FFPROBE_BINARY`: (Optional) Path to ffprobe binary\n\n## Usage\n\n### MCP Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"video-ai-subtitle\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcpcn-video-ai-subtitle-mcp\"],\n      \"env\": {\n        \"VOLCANO_APPID\": \"your-app-id\",\n        \"VOLCANO_ACCESS_TOKEN\": \"your-access-token\"\n      }\n    }\n  }\n}\n```\n\n## License\n\nMIT\n\n# 音视频字幕 API（简化版）\n\n## 概述\n- 功能：提交音/视频生成字幕任务，并查询字幕结果\n- 扣费：在“查询成功返回”时按时长扣积分（VIP也扣）\n- 去重：同一 `volcano_task_id` 仅扣一次\n\n## 鉴权\n- Header：`x-token: <用户登录令牌>`\n- 所有接口需登录态\n\n## 计费与积分\n- 换算：`1分钱 = 2积分` → `1元 = 200积分`\n- 阶梯单价（按当月累计小时数选择单价）：\n  - 0～300 小时：6.5 元/小时 → 1300 积分/小时\n  - 301～1000 小时：6 元/小时 → 1200 积分/小时\n  - 1001～3000 小时：5.6 元/小时 → 1120 积分/小时\n  - 3001～5000 小时：5 元/小时 → 1000 积分/小时\n  - 5001+ 小时：4 元/小时 → 800 积分/小时\n- 扣费时机：查询成功（`code=0`/`message=Success`）且解析到时长后扣费\n- 时长解析顺序：\n  - `data.duration`（单位秒，优先）\n  - `data.utterances` 的 `start_time`/`end_time`（单位毫秒，取整段范围，换算为秒）\n  - 兼容旧格式：`result.duration`、`result.segments`、`result.subtitles`\n- 扣减优先级：`FreePoints` → `VipPoints` → `Points`\n- 去重规则：积分流水 `reason` 前缀为 `视频字幕生成 volcano_task_id=<id>` 的记录存在即视为已扣\n\n## 接口列表\n\n### 1) 提交任务\n- Method：`POST`\n- URL：`/api/translate/videoCaption/submit`\n- Header：`x-token: <用户登录令牌>`\n- Body（JSON）：\n  - `url` 必填，媒体地址\n  - `words_per_line` 可选，默认 `46`\n  - `max_lines` 可选，默认 `1`\n  - `language` 可选，默认 `zh-CN`\n  - `caption_type` 可选，默认 `auto`\n  - `use_itn`、`use_punc`、`use_ddc`、`with_speaker_info` 可选，默认 `false…","publisher":null,"homepage":null,"repository":null,"version":"0.1.5","license":"MIT","protocols":["mcp"],"tags":["ai","ffmpeg","mcp","speech-recognition","srt","subtitle","video"],"pricing":null,"endpoints":[{"url":"pypi:mcpcn-video-ai-subtitle-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"media.video-editing","name":"Video Editing","confidence":1,"provenance":"declared"},{"slug":"media.speech-recognition","name":"Speech Recognition","confidence":1,"provenance":"declared"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcpcn-video-ai-subtitle-mcp","registry":"pypi","observedAt":"2026-11-03T12:28:05.244Z","publishedAt":"2026-01-16T09:37:04.803214Z","latestVersion":"0.1.5"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcpcn-video-ai-subtitle-mcp","url":"https://pypi.org/project/mcpcn-video-ai-subtitle-mcp/","firstSeenAt":"2026-09-10T00:25:06.289Z","fetchedAt":"2026-11-03T12:27:17.242Z","normalizedAt":"2026-11-03T12:27:17.242Z"}]},"firstSeenAt":"2026-09-10T00:25:06.289Z","updatedAt":"2026-11-03T12:28:05.244Z"}