通过 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。

错误

工具调用失败时会返回错误信息而不是结果。积分不足时,信息中会包含价格页面的链接。