Seedance 2.5 Fest · Flash and 2.5 estimated prices

Try it

MCP 接入

API

让 Cursor、Claude Code、Claude Desktop 里的 AI 直接帮你出图、出视频。连上之后,对 AI 说一句“用 tvvv 生成一张赛博朋克街景”,图就生成好了,费用从你的积分里扣,作品自动保存到作品库。

1

创建一个密钥

密钥相当于你账户的“通行证”:AI 拿着它才能用你的积分。只会显示一次,请复制保存。

API 密钥

2

连接你的 AI 工具

选你在用的工具,照着做。Cursor 和 VS Code 有一键安装按钮,最省事。

分步指引

  1. 1
    在本页「API 密钥」里创建一个密钥并复制(只显示一次,请像密码一样保管)。
  2. 2
    最省事:在下方「配置片段」点 添加到 Cursor,编辑器会自动打开并填好地址和密钥,点 Install 即可。
  3. 3
    手动也行:打开 Settings → MCP → Add new MCP server,或编辑 ~/.cursor/mcp.json,地址填:https://tvvv.ai/api/mcp
  4. 4
    请求头里加:Authorization: Bearer tvvv_sk_你的密钥
  5. 5
    回到 Settings → MCP,tvvv 出现绿点就连上了。
  6. 6
    把下方「Agent 使用说明」贴进 Settings → Rules,然后在对话里直接说:“用 tvvv 生成一张赛博朋克街景”。

配置片段

一键安装,不用改配置文件

先创建密钥,按钮会自动带上它。

添加到 Cursor添加到 VS Code
~/.cursor/mcp.json(或项目里的 .cursor/mcp.json)
{
  "mcpServers": {
    "tvvv": {
      "url": "https://tvvv.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer tvvv_sk_你的密钥"
      }
    }
  }
}

保存后在 Cursor 设置 → MCP 里确认 tvvv 显示为已连接(绿点)。

3

对 AI 说一句话

不用记工具名。连上后像平时聊天一样描述想要的画面,AI 会自己选模型、算好价格、生成并回传结果。

用 tvvv 生成一张赛博朋克风格的雨夜街景,16:9

用 tvvv 的 Seedance 做一条 5 秒视频:海边日落,镜头缓慢推近

先用 tvvv 查一下积分余额,再列出 10 元以内能做什么

示例
4

每个模型多少钱

下面每一行都是一个“典型请求”的真实价格(视频是 5 秒一条,图片是一张)。点进模型能看到全部档位和实时报价。

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-skill.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 作品库下载。