透過 MCP 連接

Aether 提供遠端 Model Context Protocol(MCP)伺服器。Claude、Claude Code、Cursor、Antigravity、Codex、ChatGPT 等支援 MCP 的 AI 助手可以透過它使用你的 Aether 帳戶生成圖像、特效和精靈,並進行圖像調整。

伺服器位址

https://api.aetherforgeai.com/mcp

使用 Streamable HTTP 傳輸方式。

使用 Aether 帳戶連接(建議)

在用戶端中新增伺服器位址。首次連接時,瀏覽器會開啟 Aether 連接頁面。

1. 如果尚未登入,請登入 Aether。登入後會自動返回連接頁面。
2. 確認用戶端名稱和將要返回的位址。
3. 選擇 連接。

之後用戶端會取得自己的存取權杖。存取權杖一小時後過期,用戶端會自動更新。

選擇你使用的用戶端:

Claude Code

claude mcp add --transport http aether https://api.aetherforgeai.com/mcp

然後在 Claude Code 中執行 /mcp 並選擇 aether 即可開始登入。

Claude

在 Claude(網頁版和桌面版)中開啟 設定 → 連接器 → 新增自訂連接器,輸入伺服器位址並選擇 新增。接著選擇 連接 開始登入。Claude 無法從聊天中上傳檔案,因此圖像輸入請傳入先前結果的 job_id。

Cursor

在 mcp.json(設定 → MCP)中新增伺服器。當伺服器顯示 Needs login 時,選擇它並在瀏覽器中登入。

{
  "mcpServers": {
    "aether": {
      "url": "https://api.aetherforgeai.com/mcp"
    }
  }
}

Antigravity

在 Antigravity CLI 中註冊伺服器並開始工作階段。首次使用該伺服器時會在瀏覽器中開啟登入。如果瀏覽器無法返回 CLI,請在 CLI 提示時貼上網址列中的最終 URL。

agy mcp add aether https://api.aetherforgeai.com/mcp
agy

Codex

註冊伺服器並登入。登入會在瀏覽器中開啟。

codex mcp add aether --url https://api.aetherforgeai.com/mcp
codex mcp login aether

ChatGPT

在 ChatGPT 中開啟 設定 → 連接器 → 進階 → 開發者模式,選擇 建立。輸入名稱和伺服器位址,驗證方式選擇 OAuth,然後依序選擇 建立 和 連接 開始登入。ChatGPT 無法從聊天中上傳檔案,因此圖像輸入請傳入先前結果的 job_id。

使用 API 金鑰連接

可以傳送自訂標頭的用戶端可以使用 API 金鑰 代替登入。Claude 和 ChatGPT 的連接器僅支援帳戶登入。

Authorization: Bearer <api_key>

Claude Code

claude mcp add --transport http aether https://api.aetherforgeai.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

在 mcp.json 的伺服器項目中新增 headers。

{
  "mcpServers": {
    "aether": {
      "url": "https://api.aetherforgeai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Antigravity

agy mcp add --header "Authorization: Bearer YOUR_API_KEY" aether https://api.aetherforgeai.com/mcp

Codex

Codex 從環境變數中讀取金鑰。

export AETHER_API_KEY=YOUR_API_KEY
codex mcp add aether --url https://api.aetherforgeai.com/mcp --bearer-token-env-var AETHER_API_KEY

工具

所有工具都使用與網頁應用程式對應頁面相同的選項和點數消耗。

工具	網頁功能	點數消耗
create_image_upload	上傳供其他工具使用的圖像	免費
get_job_status	任務狀態和結果 URL	免費
get_credit	點數餘額	免費
list_my_ai_models	可用於 Aether 生成的模型	免費
list_my_results	歷史記錄(tool、sprite、aether)	免費
generate_image	圖像生成	1 (GPT Image 2)、2 (GPT Image 2.5 High、Nano Banana Pro)、3 (GPT Image 2.5 XHigh)
generate_effect_v1	特效生成 V1 分頁	5 (1K)、7 (2K)、10 (4K)
generate_effect_v2	特效生成 V2 分頁	3
upscale	放大	5 (1K)、7 (2K)、10 (4K)
inpaint_v1	局部重繪 V1 分頁	5
inpaint_v2	局部重繪 V2 分頁	3
remove_background	去除背景	1
equip_variation	裝備變體	5
sprite_lite	Sprite Lite	依影格數 5 至 13
sprite_plus	Sprite Plus	9(49 影格)、13(81 影格)
sprite_zenith	Sprite Zenith	9(36 影格)、25(100 影格)
sprite_pulsar	Sprite Pulsar	3,Sprite To Sprite 為 4
aether_generate	Aether	包含的模型免費,其他模型 2。每個模型的費用見 list_my_ai_models 的 credit_cost

欄位名稱和允許的值與對應的 端點 頁面相同。

取得結果

生成工具會啟動非同步任務並立即傳回 job_id。使用該 job_id 呼叫 get_job_status 取得結果。設定 wait_seconds(最多 60)可以在工具傳回前等待任務完成。當 status 為 Succeed 時,image_urls 中包含結果圖像,精靈圖還包含 GIF。狀態值請參閱 非同步任務生命週期。

generate_image 也會在網頁的歷史頁面建立一個聊天室,顯示在 API/MCP 分頁下。結果中的 chat_room_id 即該聊天室,你可以在網頁中開啟它繼續生成。

圖像輸入

圖像欄位可以使用以下任一種:

• create_image_upload 傳回的 upload_id。使用圖像的 Content-Type 呼叫該工具,在 5 分鐘內透過 HTTP PUT 將檔案上傳到傳回的 upload_url,然後傳入 upload_id。
• 你已完成任務的 job_id,直接重複使用其結果圖像。這樣可以串接工具,例如先 upscale 再 remove_background。

curl -X PUT -H "Content-Type: image/png" --data-binary @character.png "<upload_url>"

上傳需要能夠執行命令或傳送 HTTP 請求的用戶端,例如 Claude Code、Cursor、Antigravity 或 Codex。在無法上傳檔案的聊天應用中,請改用已完成的 job_id。

錯誤

工具呼叫失敗時會傳回錯誤訊息而不是結果。點數不足時,訊息中會包含價格頁面的連結。