MCP 接入
API让 Cursor、Claude Code、Claude Desktop 里的 AI 直接帮你出图、出视频。连上之后,对 AI 说一句“用 tvvv 生成一张赛博朋克街景”,图就生成好了,费用从你的积分里扣,作品自动保存到作品库。
创建一个密钥
密钥相当于你账户的“通行证”:AI 拿着它才能用你的积分。只会显示一次,请复制保存。
API 密钥
连接你的 AI 工具
选你在用的工具,照着做。Cursor 和 VS Code 有一键安装按钮,最省事。
分步指引
- 1在本页「API 密钥」里创建一个密钥并复制(只显示一次,请像密码一样保管)。
- 2最省事:在下方「配置片段」点
添加到 Cursor,编辑器会自动打开并填好地址和密钥,点Install即可。 - 3手动也行:打开
Settings → MCP → Add new MCP server,或编辑~/.cursor/mcp.json,地址填:https://tvvv.ai/api/mcp - 4请求头里加:
Authorization: Bearer tvvv_sk_你的密钥 - 5回到
Settings → MCP,tvvv 出现绿点就连上了。 - 6把下方「Agent 使用说明」贴进
Settings → Rules,然后在对话里直接说:“用 tvvv 生成一张赛博朋克街景”。
配置片段
一键安装,不用改配置文件
先创建密钥,按钮会自动带上它。
{
"mcpServers": {
"tvvv": {
"url": "https://tvvv.ai/api/mcp",
"headers": {
"Authorization": "Bearer tvvv_sk_你的密钥"
}
}
}
}保存后在 Cursor 设置 → MCP 里确认 tvvv 显示为已连接(绿点)。
对 AI 说一句话
不用记工具名。连上后像平时聊天一样描述想要的画面,AI 会自己选模型、算好价格、生成并回传结果。
用 tvvv 生成一张赛博朋克风格的雨夜街景,16:9
用 tvvv 的 Seedance 做一条 5 秒视频:海边日落,镜头缓慢推近
先用 tvvv 查一下积分余额,再列出 10 元以内能做什么
每个模型多少钱
下面每一行都是一个“典型请求”的真实价格(视频是 5 秒一条,图片是一张)。点进模型能看到全部档位和实时报价。
Seedance 2.5 Flash
视频APIchinadatapay · chinadatapay/seedance-2.5-flash
最长 30 秒,480p / 720p,可配音;最多 10 张参考图、5 段参考视频 / 音频,可只用音频参考
42积分≈ ¥4.2
5 秒 · 720p 一条
5 秒一条:480p 19 / 720p 42 积分
Seedance 2.5
视频APIchinadatapay · chinadatapay/seedance-2.5
最长 30 秒,480p / 720p / 1080p,可配音;最多 30 张参考图、10 段参考视频 / 音频,可只用音频参考
63积分≈ ¥6.3
5 秒 · 720p 一条
5 秒一条:480p 28 / 720p 63 / 1080p 156 积分
Seedance 2.5 Draft
视频APIchinadatapay · chinadatapay/seedance-2.5-draft
Draft 模式:480p 快速出样片,满意再一键生成 1080p 正式版
28积分≈ ¥2.8
5 秒 · 480p 一条
5 秒一条:480p 28 积分
Seedance 2.0
视频APIchinadatapay · chinadatapay/seedance-2.0
4–15 秒,480p–4K;最多 9 张参考图、3 段参考视频 / 音频
42积分≈ ¥4.2
5 秒 · 720p 一条
5 秒一条:480p 20 / 720p 42 / 1080p 104 / 4K 211 积分
Seedance 2.0 Mini
视频APIchinadatapay · chinadatapay/seedance-2.0-mini
更轻量的 Seedance 2.0,480p / 720p
21积分≈ ¥2.1
5 秒 · 720p 一条
5 秒一条:480p 10 / 720p 21 积分
Seedance 2.0 Fast
视频APIchinadatapay · chinadatapay/seedance-2.0-fast
快速版 Seedance 2.0,480p / 720p
34积分≈ ¥3.4
5 秒 · 720p 一条
5 秒一条:480p 16 / 720p 34 积分
MiniMax H3
视频APIMiniMax · minimax/hailuo-3
音画一体,768p / 2K
7积分≈ ¥0.70
5 秒 · 768p 一条
768p 1.8 / 2K 2.8 积分/秒
MiniMax H3 Max
视频APIMiniMax · minimax/hailuo-3-max
更快更省的 H3,最长 15 秒
39积分≈ ¥3.9
5 秒 · 768p 一条
480p 4.8 / 768p 7.7 积分/秒
MiniMax H3 Max Turbo
视频APIMiniMax · minimax/hailuo-3-max-turbo
H3 Max 极速版,最便宜,最长 15 秒
12积分≈ ¥1.2
5 秒 · 480p 一条
480p 2.4 / 768p 3.9 / 1080p 7.7 积分/秒
H3 Max 多机位
视频APIMiniMax · minimax/h3-max-multi-angle
一张图,镜头绕着转;运镜在「摄像机」里选
24积分≈ ¥2.4
5 秒 · 480p 一条
480p 4.8 / 768p 7.7 / 1080p 15.3 积分/秒
H3 Max 视频风格化
视频APIMiniMax · minimax/h3-max-styles
VHS 录像带风格;像素、手绘等在「视频风格化」页选
39积分≈ ¥3.9
5 秒 · 768p 一条
768p 7.7 积分/秒
Seedance 1.5 Pro
视频APIByteDance · bytedance/seedance-1-5-pro
首尾帧,音画一体,最长 12 秒
13积分≈ ¥1.3
5 秒 · 720p 一条
720p 2.5 / 1080p 5.6 积分/秒;有声 720p 5 / 1080p 11.2
Kling 4.0
视频Kling · kwaivgi/kling-v4.0
可灵 4.0,720p / 1080p,3–30 秒,首尾帧 / 多图参考,自带声音;出片较慢(约 10–40 分钟)
42积分≈ ¥4.2
5 秒 · 720p 一条
720p 11.8 / 1080p 17.6 积分/秒
Kling 3.0 Pro
视频Kling · kwaivgi/kling-v3.0-pro
专业画质,首尾帧,3–15 秒
17积分≈ ¥1.7
5 秒 · 720p 一条
720p 3.4 积分/秒;有声 720p 5
Kling O3 Pro
视频Kling · kwaivgi/kling-o3-pro
固定 1080p(不是 2K / 4K),首尾帧,3–15 秒,可配音
54积分≈ ¥5.4
5 秒 · 1080p 一条
1080p 10.7 积分/秒;有声 1080p 13.4
Kling 3.0 Standard
视频Kling · kwaivgi/kling-v3.0-std
标准画质,首尾帧,3–15 秒
17积分≈ ¥1.7
5 秒 · 720p 一条
720p 3.4 积分/秒;有声 720p 5
Kling 2.6
视频Kling · klingai/kling-v2.6
720p 标准 / 1080p 专业(专业档可配音),5 或 10 秒
20积分≈ ¥2.0
5 秒 · 720p 一条
720p 4 / 1080p 6.7 积分/秒;有声 720p 4 / 1080p 13.4
Kling 2.5 Turbo
视频Kling · klingai/kling-v2.5-turbo
更快更省,720p 标准 / 1080p 专业,5 或 10 秒
20积分≈ ¥2.0
5 秒 · 720p 一条
720p 4 / 1080p 6.7 积分/秒
10 积分 = 1 元。价格是非会员标价,会员积分更便宜;生成前先冻结、完成后按实际结算,失败不扣费。点任意模型看参数、示例代码和实时报价。
可用工具
list_models列出可用的图片 / 视频模型、参数和价格
get_balance查询积分余额和可用额度
generate_image生成 1–4 张图片(同步,返回签名链接)
generate_video提交视频任务(异步,立即返回 job_id)
get_job_status查询视频进度,完成后返回签名链接
每次生成前按预估校验余额(会扣除进行中视频任务占用的额度),不够直接拒绝、不扣费;实际按用量扣积分,通常不高于预估。返回的链接约 6 小时有效,作品永久保存在作品库。
Agent 使用说明(skill)
把下面这段贴给你的 Agent(例如 Cursor 的 Rules、Claude 的项目说明 / CLAUDE.md、或对话开头),它就知道什么时候用哪个工具、怎么写提示词、视频要轮询。
# tvvv.ai 生成工具(MCP)使用说明
你可以通过 tvvv MCP 工具为用户生成图片和视频,费用从用户的 tvvv.ai 积分里扣(10 积分 = 1 元人民币,按模型实际用量计费;list_models 会给出每个模型的积分价格),结果自动保存到用户的 tvvv.ai 作品库。
## 什么时候用哪个工具
- list_models:第一次使用、或用户没指定模型时先调用,查看模型 id、支持的比例/分辨率/时长和价格。
- get_balance:生成前(尤其是视频)确认可用积分;余额不足时告诉用户去 https://tvvv.ai/account?tab=billing 充值,不要反复重试。
- generate_image:出图(同步,约 10–60 秒)。便宜试稿用 meta/muse-image;要高质量或改图(带参考图)用 Seedream / GPT Image / Nano Banana。
- generate_video:出视频(异步)。立即返回 job_id,不会马上出片。
- get_job_status:拿 job_id 轮询视频进度。
## 视频要几分钟
- 视频通常 1–10 分钟。提交后每 20–30 秒调用一次 get_job_status,直到 status 为 completed(拿 video_url)或 failed(把 error 原样告诉用户)。
- 不要重复提交同一个视频来"加速",每次提交都会占用积分。
- 先用短时长、低分辨率(如 5 秒 720p)确认效果,再出长片/高清。
## 提示词技巧
- 图片:主体 + 外观细节 + 场景 + 构图/镜头 + 光线 + 风格;需要画面里出现文字时,用引号写出确切文字。
- 视频:一句话写清主体和动作,再写镜头运动(推近、环绕、跟拍)、节奏、风格和声音;一个镜头只写一件主要的事。
- 图生视频:first_frame_url 传首帧图片(公网 https 链接),提示词只描述"接下来发生什么"。
- 参考图、首尾帧都必须是公网 https:// 链接(可以用 generate_image 返回的链接)。
## 费用与安全
- 每次生成前会按预估校验余额,不够会直接拒绝并返回所需积分。
- 实际扣费按用量结算,通常不高于预估。
- 返回的图片/视频链接约 6 小时后过期,需要长期保存请让用户在 tvvv.ai 作品库下载。