> ## Documentation Index
> Fetch the complete documentation index at: https://docs.token.poryf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 AI 助手里出图出视频（MCP）

> 把再来点Token的生图、生视频接入 WorkBuddy、Claude Code、Cursor 等支持 MCP 的 AI 助手，说一句话就能出图出视频，费用从本站余额扣。

本站提供一个远程 MCP 服务。接入后，你在 AI 助手里描述想要的画面，助手会自己选模型、填参数，调用本站生成图片或视频，并把链接交给你。费用和直接调用 API 一样，从本站余额扣，使用日志里能看到每一次调用。

| 项目 | 内容 |
| - | - |
| 服务地址 | `https://token.poryf.com/mcp/studio` |
| 传输方式 | Streamable HTTP |
| 认证 | 请求头 `Authorization: Bearer YOUR_API_KEY` |

## 准备

* 在 [API 密钥](https://token.poryf.com/keys) 页面**单独建一个密钥**给 MCP 用，并给它设置**额度上限**。助手可能连续生成多张图或多段视频，额度上限就是这个密钥最多能花的钱。
* 确认 [钱包](https://token.poryf.com/wallet) 有余额。

> [!WARNING]
>
> 配置里会写入完整的 API 密钥。只在自己的电脑上配置，不要把配置文件发给别人或提交到代码仓库。

## WorkBuddy

1. 打开 **专家·技能·连接器 → 连接器 → 自定义连接器**，点 **添加 MCP**，或者直接编辑 `~/.workbuddy/mcp.json`（Windows 为 `%USERPROFILE%\.workbuddy\mcp.json`）。
2. 在 `mcpServers` 里加入下面这一项，把 `YOUR_API_KEY` 换成你的密钥，然后保存：

```json theme={null}
{
  "mcpServers": {
    "tokendiscount": {
      "type": "http",
      "url": "https://token.poryf.com/mcp/studio",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "timeout": 600000
    }
  }
}
```

3. 回到 MCP 服务管理列表，在 `tokendiscount` 下点 **信任**。状态变绿、显示 5 个工具已启用，就是接好了。
4. 新建一个任务，说出你的需求，例如「用再来点Token生成一段 720p、5 秒的视频：清晨海边，一只柯基在沙滩上奔跑」。

## Claude Code

```bash theme={null}
claude mcp add --transport http tokendiscount https://token.poryf.com/mcp/studio --header "Authorization: Bearer YOUR_API_KEY"
```

## Cursor 等其他客户端

支持远程 MCP 的客户端，按它的格式填写服务地址和请求头即可。以 Cursor 的 `~/.cursor/mcp.json` 为例：

```json theme={null}
{
  "mcpServers": {
    "tokendiscount": {
      "url": "https://token.poryf.com/mcp/studio",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

## 提供的工具

| 工具 | 作用 | 收费 |
| - | - | - |
| `list_models` | 列出可用的图片、视频模型，以及每个模型的选项和参考价 | 免费 |
| `get_balance` | 查询账户余额和这个密钥的剩余额度 | 免费 |
| `generate_image` | 生成一张图片，返回图片链接 | 按模型计费 |
| `create_video` | 提交视频生成任务，返回任务 ID | 按模型计费 |
| `get_video` | 查询视频任务进度，完成后返回视频链接 | 免费 |

目前可用的模型：

* 图片：`gpt-image-2`、`qwen-image-3.0`、`wan2.7-image-pro`
* 视频：Seedance 2.5、Seedance 2.0、2.0 Fast、2.0 Mini

参考图需要是公网可访问的图片链接，或者 [素材库](https://docs.token.poryf.com/api/assets.md) 里的 `asset://` 素材 ID；不支持直接传本地文件。

## 费用与确认

* 每次生成前，服务会按模型的实时价格估算这次的费用。**估算在 10 元及以上，或者无法估算时，不会直接生成**，而是把价格告诉助手，助手要先问过你，得到同意后才会提交。
* 估算按你的分组倍率计算，实际扣费以 [使用日志](https://docs.token.poryf.com/account/logs.md) 为准；Seedance 按实际用量多退少补。
* 失败的生成不收费，视频任务失败会自动退款。服务会提醒助手不要自行重试，避免重复扣费。
* 图片和视频链接一般保存 30 天，少数图片链接 24 小时内就会过期（工具会在返回结果里说明），请及时下载。

## 无法调用

* **提示 401 或密钥无效**：检查请求头是否写成 `Bearer ` 加上完整密钥，以及密钥是否被禁用或过期。
* **提示余额不足**：给钱包充值，或者调高这个密钥的额度上限。
* **模型不在列表里**：检查密钥是否设置了可用模型范围。
* **改了配置不生效**：保存后新建任务；部分客户端需要重启。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.