Aisma

Aisma MCP 服务和 API

只需用自然语言描述修改内容，即可通过任意 AI 助手、Agent 或脚本编辑已拍摄的视频。 移除人物或物体、更换服装、背景或产品、替换为你照片中的人脸、重新设计片段的风格或添加特效。Aisma 会保留原始画面构图和音频，并将私密的 720p 或 1080p 成片交付到你的 Aisma Library。

• MCP 服务（远程，Streamable HTTP）： https://api.aisma.ai/mcp
• REST API： https://api.aisma.ai/v1 (OpenAPI 3.1)
• 开发者文档： https://aisma.ai/developers
• 官方 MCP Registry 名称： ai.aisma/aisma

此仓库包含文档、Registry server.json 和一些小型客户端示例。服务本身由 Aisma 托管，无需安装或运行任何内容。

所需条件

• 一个使用 Google、Apple 或电子邮件登录的 Aisma 账户。访客资料无法连接应用或保存密钥。
• 该账户中有积分。编辑消耗的积分与 Aisma 应用相同，每次编辑开始前都会显示价格。积分在 Aisma 中购买，不能通过 API 或 MCP 购买。价格：https://aisma.ai/pricing
• 一个时长为 2–60 秒的视频片段（MP4 或 MOV，最大 500 MB），或 Aisma Library 中已完成的视频。 可选：最多 10 张参考照片（JPEG、PNG 或 WebP）。

连接 AI 助手（MCP）

客户端首次使用时会打开 Aisma 登录页面：采用 OAuth 2.1 和 PKCE，并支持动态客户端注册，因此无需复制客户端 ID。在授权页面，你可以选择此连接可以执行的操作及其每月积分上限。你可以随时在 Aisma 的 Profile → Settings & help → Connected apps and keys（https://aisma.ai/app/api-access）中更改限额或断开连接。

想使用密钥？在同一页面创建个人 API 密钥，并将其作为 Authorization: Bearer aisma_live_… 发送。 每个密钥都有自己的权限和限额，可在该页面逐个调整。

Claude Code

claude mcp add --transport http aisma https://api.aisma.ai/mcp
# or with a personal API key
claude mcp add --transport http aisma https://api.aisma.ai/mcp --header "Authorization: Bearer $AISMA_API_KEY"

Cursor（~/.cursor/mcp.json 或项目中的 .cursor/mcp.json）

{
  "mcpServers": {
    "aisma": { "url": "https://api.aisma.ai/mcp" }
  }
}

使用密钥时，在 url 旁添加 "headers": { "Authorization": "Bearer aisma_live_…" }。

VS Code（.vscode/mcp.json）

{
  "servers": {
    "aisma": { "type": "http", "url": "https://api.aisma.ai/mcp" }
  }
}

ChatGPT（在你的方案和工作区允许使用自定义 MCP 服务的情况下）：打开 chatgpt.com/plugins，选择 + → Add custom MCP server，输入 https://api.aisma.ai/mcp，选择 OAuth 并登录 Aisma。

Claude.ai 和 Claude Desktop： Settings → Connectors → Add custom connector → https://api.aisma.ai/mcp。

**其他客户端：**任何支持通过 Streamable HTTP 使用远程 MCP 服务的客户端均可使用。该服务是无状态的，并响应协议版本 2025-11-25、2025-06-18 和 2025-03-26。未经身份验证的请求会收到带有 WWW-Authenticate: Bearer resource_metadata=… 的 401 响应，客户端据此发现登录方式。

仅支持聊天的助手：一个需要说明的限制

视频文件不会通过 MCP 消息传输。create_upload 会返回一个一次性 HTTPS 链接，由助手自行通过 HTTP PUT 上传文件。这适用于能够读取你的文件并运行命令的助手（Claude Code、Cursor、VS Code 和其他编码 Agent）。仅支持聊天的助手（ChatGPT、Claude.ai）无法通过此方式上传新视频片段；不过，它们可以重新编辑 Aisma Library 中已完成的视频（list_library → use_library_video）。

工具

工具	功能	是否消耗额度
create_upload	返回一个一次性 HTTPS 上传链接和视频或照片的素材 ID；助手会自行 PUT 文件	否
get_asset	上传状态：上传中、检查中、就绪、失败或已过期	否
use_library_video	使用你的一段已完成的 Aisma 视频作为新剪辑的源素材	否
quote_edit	根据你的指示和可选照片，为就绪的源素材剪辑报价，可选择 720p 或 1080p；不会扣费，报价有效期为 15 分钟	否
start_edit	开始已报价的剪辑并预留额度；此操作标记为有破坏性，助手会先向你确认	是，确认后
get_job	剪辑的状态和进度	否
list_library	你的 Aisma Library，按最新优先排列，并显示每段剪辑的状态	否
get_result_link	已完成视频的私密链接，有效期为一小时	否
get_account	你的额度余额，以及此连接的月度限额和用量	否

每个工具都有标题、只读或有破坏性的提示，以及输出架构。

试试看

• “将 ~/Videos/wedding.mov 上传到 Aisma，并移除这对新人身后穿红色夹克的男人。开始前先询问我。”
• “在 product.mp4 中，将透明香水瓶替换为 bottle.jpg 中的哑光黑色香水瓶。”
• “将 dance.mp4 中她的灰色运动服换成 photo.png 中的红色套装。”
• “取我最近完成的 Aisma 视频，以 1080p 将走廊变成积雪覆盖的松树林。”
• “检查我的 Aisma 剪辑，准备好后把链接发给我。”

REST API 快速入门

将密钥作为 bearer token 发送，并设置描述性的 User-Agent 标头（例如 my-app/1.0）：我们的边缘网络会拒绝某些 HTTP 库的默认 User-Agent。请求正文为 JSON，ID 为 UUID。

1. POST /v1/uploads 会返回 uploadUrl、method（PUT）和 headers。使用这些标头将文件 PUT 到该地址。
2. 轮询 GET /v1/assets/{id}，直到 status 为 ready。
3. POST /v1/quotes 为剪辑报价。返回 202 和 retryAfterMs 表示剪辑仍在检查中；请在该延迟时间后重试。
4. 在 POST /v1/jobs 请求中添加 Idempotency-Key 标头，开始已报价的剪辑。使用相同密钥重试会返回同一段剪辑。
5. 轮询 GET /v1/jobs/{id}（间隔不得短于 10 秒）或注册 webhook，然后调用 POST /v1/jobs/{id}/result 获取一个有效期为一小时的链接。

export AISMA_API_KEY=aisma_live_...
UA="my-app/1.0"

curl -s -X POST https://api.aisma.ai/v1/uploads \
  -H "Authorization: Bearer $AISMA_API_KEY" -H "User-Agent: $UA" -H "Content-Type: application/json" \
  -d '{"kind":"video","contentType":"video/mp4","bytes":12345678}'
# PUT clip.mp4 to uploadUrl with the returned headers, then wait for GET /v1/assets/ASSET_ID → ready

curl -s -X POST https://api.aisma.ai/v1/quotes \
  -H "Authorization: Bearer $AISMA_API_KEY" -H "User-Agent: $UA" -H "Content-Type: application/json" \
  -d '{"sourceId":"ASSET_ID","brief":"change the background to a snowy forest","quality":"720p"}'

curl -s -X POST https://api.aisma.ai/v1/jobs \
  -H "Authorization: Bearer $AISMA_API_KEY" -H "User-Agent: $UA" -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-edit-0001" \
  -d '{"quoteId":"QUOTE_ID"}'

curl -s -X POST https://api.aisma.ai/v1/jobs/JOB_ID/result \
  -H "Authorization: Bearer $AISMA_API_KEY" -H "User-Agent: $UA"

以下完整脚本可用于上传、报价、请求确认、开始剪辑并下载：

• examples/edit.sh（curl + jq）
• examples/edit.py（Python 3 + requests）
• examples/edit.mjs（Node.js 18+ fetch）

错误均采用同一种 JSON 格式：{"error": {"code", "message"}}，并附有易读的消息。Webhook （job.completed、job.failed、job.settled）依据 Standard Webhooks 进行签名。作用域、限额、webhook 和错误表请参阅 https://aisma.ai/developers。

隐私、条款与支持

• 上传内容和结果仅对你的账户可见；所有媒体链接均经过签名，且有效期较短。
• 使用条款（第 8 节，API 和已连接的应用）：https://aisma.ai/terms
• 隐私政策：https://aisma.ai/privacy
• 定价：https://aisma.ai/pricing
• 支持：[email protected] · https://aisma.ai/support

Aisma 由新加坡的 BEINTOUCH PTE. LTD. 打造。

许可证

此代码库中的示例和文档依据 MIT License 发布。 Aisma 服务本身受上述使用条款约束。