极光 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，不需要自己部署。

能做什么

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

Related MCP server: avots-mcp

价格示例

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

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

图片模型

视频模型

接入：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 工具

接入：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 许可发布。调用接口产生的费用和内容合规由调用方负责，使用前请阅读服务条款。