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

让 Claude Code、Cursor、Codex、Trae 等 AI Agent 直接调用图片和视频生成模型（Seedance、Veo、Wan、Grok、GPT-Image、Nano Banana 等）的远程 MCP 服务，同一套能力也提供 REST API。由极光 AI（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.

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

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

能做什么

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

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

价格示例

下面是 2026-11-13 03:58（北京时间）的工作台价格快照（人民币按「体验档」档位（¥30 = 60 积分）折算，¥0.5/积分）。模型会上新、下线和调价，以实时价格表为准；通过接口调用时，开放了哪些模型、每个模型当前的价格，都以接口 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

接入：MCP（推荐）

先在开发者中心创建 API Key，放进环境变量 AI_MEDIA_API_KEY（不要写进代码仓库、截图或日志）。开发者中心也可以选好 Agent 后一键复制带 Key 的接入指令。

Claude Code

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）

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

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

{
  "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/。

# 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：只用 Python 标准库，按最低价挑一个图片模型出一张图
examples/quickstart.mjs：Node.js 18+ 版本
接口定义：OpenAPI JSON；文档：developers/docs

Agent Skill

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

常见问题

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

多少钱？ 按积分计费，每个模型每次生成的积分和人民币参考价见模型价格表，数据实时生成。

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

参考图要先上传吗？ 网络图片链接（任何公开可访问的 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 许可发布。调用接口产生的费用和内容合规由调用方负责，使用前请阅读服务条款。

ai-media

Documentation