Aisma

Aisma MCP サーバーと API

撮影済みの動画を、AI アシスタント、エージェント、またはスクリプトから、普段使う言葉で変更内容を説明するだけで編集できます。人物や物を削除したり、衣装、背景、商品を変更したり、写真から顔を入れ替えたり、クリップのスタイルを変更したり、エフェクトを追加したりできます。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 のサインインページが開きます。PKCE と動的クライアント登録を使用する OAuth 2.1 方式のため、コピーするクライアント ID はありません。同意画面では、接続に許可する操作と月ごとのクレジット上限を選択します。上限の変更や接続解除は、Aisma の プロフィール → 設定とヘルプ → 接続済みアプリとキー（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" }
  }
}

キーを使用する場合は、"headers": { "Authorization": "Bearer aisma_live_…" } を url の隣に追加してください。

VS Code（.vscode/mcp.json）

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

ChatGPT（プランとワークスペースでカスタム MCP サーバーが許可されている場合）：chatgpt.com/plugins を開き、＋ → カスタム MCP サーバーを追加を選択して、https://api.aisma.ai/mcp を入力し、OAuth を選んで Aisma にサインインしてください。

Claude.ai と Claude Desktop： 設定 → コネクタ → カスタムコネクタを追加 → 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、その他のコーディングエージェント）で機能します。チャット専用アシスタント（ChatGPT、Claude.ai）では、この方法で新しいクリップをアップロードできません。その場合は、Aisma Library にすでにある完成済みの動画を再編集できます（list_library → use_library_video）。

ツール

ツール	機能	クレジットを消費
create_upload	動画または写真用の1回限りのHTTPSアップロードリンクとアセットIDを返します。アシスタントがファイルを直接PUTします	いいえ
get_asset	アップロードの状態を返します：uploading、checking、ready、failed、expired	いいえ
use_library_video	完成済みのAisma動画の1つを、新しい編集のソースとして使用します	いいえ
quote_edit	ready状態のソースを、指示と任意の写真に基づいて720pまたは1080pで編集する料金を見積もります。料金は発生せず、見積もりは15分間有効です	いいえ
start_edit	見積もり済みの編集を開始し、クレジットを確保します。破壊的操作としてマークされており、アシスタントは事前に確認します	はい、確認後
get_job	編集の状態と進捗を返します	いいえ
list_library	Aismaライブラリを新しい順に表示し、各編集の状態を返します	いいえ
get_result_link	完成した動画への非公開リンクを返します。有効期間は1時間です	いいえ
get_account	クレジット残高、この接続の月間上限と使用量を返します	いいえ

各ツールには、タイトル、読み取り専用または破壊的操作を示すヒント、出力スキーマがあります。

お試しください

• 「~/Videos/wedding.movをAismaにアップロードして、カップルの後ろにいる赤いジャケットの男性を消してください。開始する前に確認してください。」
• 「product.mp4の透明な香水ボトルを、bottle.jpgのマットブラックのボトルに差し替えてください。」
• 「dance.mp4の彼女のグレーのトラックスーツを、photo.pngの赤いスーツに変えてください。」
• 「完成した最新のAisma動画を使って、廊下を雪の積もった松林に変えてください。解像度は1080pにしてください。」
• 「Aismaの編集状況を確認して、準備ができたらリンクを送ってください。」

REST API クイックスタート

キーをベアラートークンとして、説明的なUser-Agentヘッダー（例：my-app/1.0）とともに送信してください。一部のHTTPライブラリでは、デフォルトのユーザーエージェントがエッジネットワークで拒否されます。リクエストボディはJSON、IDはUUIDです。

1. POST /v1/uploadsはuploadUrl、method（PUT）、headersを返します。これらのヘッダーを付けて、ファイルをそのURLにPUTします。
2. GET /v1/assets/{id}をポーリングし、statusがreadyになるまで待ちます。
3. POST /v1/quotesで編集料金を見積もります。retryAfterMsを含む202が返された場合、クリップの確認中です。その時間が経過してから再度リクエストしてください。
4. Idempotency-Keyヘッダーを付けてPOST /v1/jobsを実行すると、見積もり済みの編集が開始されます。同じキーで再試行すると、同じ編集が返されます。
5. GET /v1/jobs/{id}をポーリングする（10秒より短い間隔でポーリングしないでください）か、Webhookを登録します。その後、POST /v1/jobs/{id}/resultを実行して1時間有効なリンクを取得します。

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サービス自体には、上記の利用規約が適用されます。