# 极光 AI 图片 / 视频生成 MCP 与 API

> 让 Claude Code、Cursor、Codex、Trae 等 AI Agent 直接调用图片和视频生成模型（Seedance、Veo、Wan、Grok、GPT-Image、Nano Banana 等）的远程 MCP 服务，同一套能力也提供 REST API。由 [极光 AI](https://vi.91jiguang.com)（TK极光旗下的 AI 创作工作台）提供。

**English**: A hosted (remote) MCP server and REST API that lets AI agents generate images and videos with models such as Seedance, Veo, Wan, Grok, GPT-Image and Nano Banana. Pay-as-you-go credits, no local install. See [README.en.md](README.en.md).

- MCP 地址：`https://vi.91jiguang.com/api/mcp`（Streamable HTTP）
- REST 接口：`https://vi.91jiguang.com/api/v1`
- 鉴权：`Authorization: Bearer <API Key>`，API Key 在[开发者中心](https://vi.91jiguang.com/developer)创建
- 计费：按积分。查模型、查任务不扣积分；创建任务才扣，失败自动退回
- 实时价格：[模型价格表](https://vi.91jiguang.com/model-pricing)（[Markdown 版](https://vi.91jiguang.com/model-pricing.md)）
- 给 Agent 读的完整说明：[agent-guide.md](https://vi.91jiguang.com/api/v1/agent-guide.md)（内容随线上更新，以它为准）

这个仓库放的是接入配置、示例代码和一个 Agent Skill。服务本身托管在极光 AI，不需要自己部署。

## 能做什么

| 场景 | 说明 |
| --- | --- |
| 电商商品图 | 商品主图、模特上身图、场景图、海报，支持参考图 |
| 带货短视频 | 文生视频、图生视频，部分模型支持参考视频 |
| 放进画布继续改 | 生成结果可以放进极光 AI 创作画布，在网页里接着编辑 |

模型、参数和价格会调整，一律以接口实时返回为准（MCP 的 `list_image_models` / `list_video_models`，或 REST 的 `GET /models`）。

<!-- PRICES:START -->
## 价格示例

下面是 2026-11-13 03:58（北京时间）的工作台价格快照（人民币按「体验档」档位（¥30 = 60 积分）折算，¥0.5/积分）。模型会上新、下线和调价，**以[实时价格表](https://vi.91jiguang.com/model-pricing)为准**；通过接口调用时，开放了哪些模型、每个模型当前的价格，都以接口 GET /models 的返回为准。

「/次」是每次生成扣的积分；「/张」「/条」是按数量计费，一次生成多张图或多条视频时乘以数量。

**图片模型**

| 模型 | 价格 | 约合人民币 | 分辨率 |
| --- | --- | --- | --- |
| GPT-Image-2.6 GIF动图 | 0.06 积分/次 | ¥0.03 | 1K |
| GPT-Image-2.6 最强 | 0.06–0.12 积分/次 | ¥0.03–¥0.06 | 1K / 2K / 4K |
| GPT-Image-2.5-sunburst | 0.06–0.12 积分/次 | ¥0.03–¥0.06 | 1K / 2K / 4K |
| GPT-Image-2.5-flare 快速 | 0.06–0.12 积分/次 | ¥0.03–¥0.06 | 1K / 2K / 4K |
| GPT-Image-2 | 0.06–0.12 积分/张 | ¥0.03–¥0.06 | 1K / 2K / 4K |
| Nano Banana 2.1 | 0.15 积分/张 | ¥0.075 | 1K |
| Gemini 3.1 Flash Image | 0.15–0.18 积分/张 | ¥0.075–¥0.09 | 1K / 2K |

**视频模型**

| 模型 | 价格 | 约合人民币 | 时长 | 分辨率 |
| --- | --- | --- | --- | --- |
| Grok1.5 Pro | 0.6–5.2 积分/次 | ¥0.3–¥2.6 | 3–15 秒 | 480p / 720p |
| MiniMax H3 | 1.3–3 积分/次 | ¥0.65–¥1.5 | 5–15 秒 | 480p / 768p |
| Gemini Omni 1.2 | 1.4–2.5 积分/条 | ¥0.7–¥1.25 | 4–15 秒 | 720p |
| Gemini Omni | 1.4–3.6 积分/条 | ¥0.7–¥1.8 | 4–20 秒 | 720p |
| Veo 3.1 Lite | 1.8 积分/条 | ¥0.9 | 8 秒 | 720p |
| Veo 3.1 Fast | 2–2.4 积分/条 | ¥1–¥1.2 | 8 秒 | 720p / 1080p |
| Muse | 2–4 积分/次 | ¥1–¥2 | 5–10 秒 | 720p |
| Veo 3.1 满血 | 2.5–3 积分/条 | ¥1.25–¥1.5 | 8 秒 | 720p / 1080p |
| Seedance2.0-Mini | 4–11 积分/次 | ¥2–¥5.5 | 5–15 秒 | — |
| Seedance2.0 Fast | 5 积分/次 | ¥2.5 | 4–15 秒 | 720p |
| Seedance2.5 | 8–35 积分/次 | ¥4–¥17.5 | 5–30 秒 | 720p / 480p |
| Wan 3.0 | 12–28 积分/次 | ¥6–¥14 | 5–30 秒 | 480p / 720p |
| Seedance2.0 满血 | 14 积分/次 | ¥7 | 4–15 秒 | 720p |
| Seedance2.5 按次 | 20–30 积分/次 | ¥10–¥15 | 5–30 秒 | 720p |

<!-- PRICES:END -->

## 接入：MCP（推荐）

先在[开发者中心](https://vi.91jiguang.com/developer)创建 API Key，放进环境变量 `AI_MEDIA_API_KEY`（不要写进代码仓库、截图或日志）。开发者中心也可以选好 Agent 后一键复制带 Key 的接入指令。

**Claude Code**

```bash
claude mcp add --transport http ai-media https://vi.91jiguang.com/api/mcp --header "Authorization: Bearer $AI_MEDIA_API_KEY"
```

**Cursor**（`.cursor/mcp.json` 或全局 `~/.cursor/mcp.json`）

```json
{
  "mcpServers": {
    "ai-media": {
      "url": "https://vi.91jiguang.com/api/mcp",
      "headers": { "Authorization": "Bearer <API Key>" }
    }
  }
}
```

**其他支持 MCP 的客户端**（通用写法）

```json
{
  "mcpServers": {
    "ai-media": {
      "type": "http",
      "url": "https://vi.91jiguang.com/api/mcp",
      "headers": { "Authorization": "Bearer <API Key>" }
    }
  }
}
```

不同客户端的字段名略有差异：`type` 可能写作 `http`、`streamableHttp` 或 `streamable-http`，地址字段可能叫 `url` 或 `httpUrl`，按各自的配置格式来。

### MCP 工具

| 工具 | 用途 | 是否扣积分 |
| --- | --- | --- |
| `list_image_models` / `list_video_models` | 查可用模型、参数组合和价格 | 否 |
| `create_image_generation` / `create_video_generation` | 创建生成任务（需传 `confirmed: true` 和稳定的 `idempotency_key`） | 是，失败退回 |
| `get_generation` | 查进度和结果 | 否 |
| `prepare_image_upload` | 参考图是本地文件时申请上传地址；网络图片链接直接用，不必上传 | 否 |
| `list_canvases` / `create_canvas` / `get_canvas` | 画布列表、新建、读取 | 否 |
| `import_generation_to_canvas` | 把成功的图片或视频放进画布 | 否 |

## 接入：REST API

三步：查模型 → 创建任务 → 轮询结果。完整示例见 [`examples/`](examples)。

```bash
# 1. 查模型（不扣积分）
curl "https://vi.91jiguang.com/api/v1/models" -H "Authorization: Bearer $AI_MEDIA_API_KEY"

# 2. 创建任务（扣积分；重试时保持同一个 Idempotency-Key）
curl -X POST "https://vi.91jiguang.com/api/v1/generations" \
  -H "Authorization: Bearer $AI_MEDIA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-001" \
  -d '{ "model": "<第 1 步返回的模型 id>", "input": { "prompt": "白色纯棉圆领 T 恤商品主图，纯白背景，1:1 构图" }, "parameters": {} }'

# 3. 每 5–10 秒查一次，直到 status 为 succeeded / failed / canceled
curl "https://vi.91jiguang.com/api/v1/generations/<任务 id>" -H "Authorization: Bearer $AI_MEDIA_API_KEY"
```

- [`examples/quickstart.py`](examples/quickstart.py)：只用 Python 标准库，按最低价挑一个图片模型出一张图
- [`examples/quickstart.mjs`](examples/quickstart.mjs)：Node.js 18+ 版本
- 接口定义：[OpenAPI JSON](https://vi.91jiguang.com/api/v1/openapi.json)；文档：[developers/docs](https://vi.91jiguang.com/developers/docs)

## Agent Skill

[`skills/ai-media/SKILL.md`](skills/ai-media/SKILL.md) 是一份可以放进 Claude Code 等支持 Skill 的 Agent 里的技能说明：什么时候用、先查模型再生成、扣费前确认、结果怎么交给用户。

## 常见问题

**需要自己部署吗？** 不需要。MCP 服务和接口都托管在极光 AI，这个仓库只有配置和示例。

**多少钱？** 按积分计费，每个模型每次生成的积分和人民币参考价见[模型价格表](https://vi.91jiguang.com/model-pricing)，数据实时生成。

**生成失败会扣积分吗？** 不会，失败自动退回。

**参考图要先上传吗？** 网络图片链接（任何公开可访问的 http(s) 地址）直接放进 `input.images`；只有本地文件才需要先申请上传地址。

**和 TK极光插件是什么关系？** 同一家的两个产品。TK极光插件是 TikTok Shop 商家后台里用的浏览器插件（商品机会提报、秒杀活动批量创建、选品采集等），官网 <https://www.91jiguang.com>；极光 AI 是 AI 创作工作台和这套开发者接口。

## 链接

- 极光 AI 工作台：<https://vi.91jiguang.com>
- 模型价格表：<https://vi.91jiguang.com/model-pricing>
- 接口文档：<https://vi.91jiguang.com/developers/docs>
- Agent 接入指南：<https://vi.91jiguang.com/api/v1/agent-guide.md>
- TK极光官网：<https://www.91jiguang.com>
- 问题反馈：在本仓库提 Issue，或加客服微信 TK-Lxy1

## 许可

示例代码和文档以 [MIT](LICENSE) 许可发布。调用接口产生的费用和内容合规由调用方负责，使用前请阅读[服务条款](https://vi.91jiguang.com/terms-of-service)。