花费前先检查
读取账号余额和实时图片/视频模型价格，并标记 MCP 图片生成工具当前可使用的 Gemini 模型。
Remote MCP · OAuth · Streamable HTTP
给你的 Agent 接上一条图片流水线。
连接一次 Pixapi，Agent 就能查看实时价格、提交 Gemini 图片任务并取回最终结果，全程不需要处理 API Key。
连接地址
https://api.pixapi.ai/mcp无需 Node.js无需复制 API Key支持异步任务结果
remote / stateless
01connecthttps://api.pixapi.ai/mcp
02authOAuth + PKCE
03scopepixapi:tools
04transportStreamable HTTP
授权后即可使用三个 Pixapi 工具
请将此 URL 添加为 Remote MCP Server。该地址接收 MCP 请求，不是普通浏览器页面。
MCP 能做什么
三个工具，完成一次图片任务。
公开 MVP 只聚焦 Agent 完成图片生成所需的关键步骤：确认价格、提交任务、获取结果。
创建图片任务
使用受支持的 Gemini 模型、提示词、图片数量和可选宽高比，提交异步文生图任务。
带着结果回来
轮询当前账号拥有的任务，完成后返回图片 URL，失败时返回已记录的错误。
OAuth 授权
登录 Pixapi，不要粘贴密钥。
支持 Remote MCP 和 OAuth 的客户端会自动发现 Pixapi 授权服务器，并使用带 S256 PKCE 的授权码流程。
客户端获得的是受限授权
授权仅限 pixapi:tools scope。Pixapi 密码只在 pixapi.ai 输入，之后客户端使用可撤销的 access token 和 refresh token。
- 01
添加 Remote MCP 地址
在客户端的连接器或 MCP 设置中添加 https://api.pixapi.ai/mcp。
- 02
在浏览器继续
Pixapi 会打开登录页，请使用拥有积分和生成记录的同一正式账号。
- 03
批准工具权限
确认并授予该客户端请求的 pixapi:tools 权限。
- 04
返回 Agent
客户端完成 OAuth 交换、列出工具，然后就能在你的账号范围内调用它们。
三个公开工具
动作明确，结果结构化。
每个工具都公开输入和输出 Schema，Agent 可以有意识地选择工具并稳定处理结果。
tool.01
pixapi_get_pricing_and_balance
返回当前积分余额，以及实时图片/视频模型价格目录。
只有标记为 mcp_generate_supported=true 的条目才能传给 MCP 图片生成工具。
tool.02
pixapi_generate_image
创建一个 Gemini 异步文生图任务，并立即返回 task_id。
当前 MCP 工具暂不支持 GPT Image 模型、图片编辑或视频生成。
tool.03
pixapi_get_task
读取当前账号任务的最新状态、进度、费用、结果 URL 或错误。
已有任务请轮询此工具，不要重新提交生成请求。
客户端支持
只要支持标准 Remote MCP + OAuth，就能连接。
默认接入路径是标准 Remote MCP + OAuth。是否开放自定义远程连接器，还会受客户端版本、套餐和工作区策略影响。
标准支持路径
Remote MCP + OAuth 客户端
如果客户端支持 Streamable HTTP、Protected Resource 发现、动态客户端注册和 PKCE，可直接使用连接地址。
请检查客户端
ChatGPT、Claude、VS Code 等
当你的套餐和客户端版本开放带 OAuth 的自定义 Remote MCP Server 时即可连接；具体可用性由客户端厂商控制。
Bridge 尚未公开
仅支持 stdio 的客户端
面向部分 Claude Code、Cursor 等 stdio 配置的一键原生/npm bridge，尚不属于公开 MVP。
Pixapi 不宣称兼容所有 MCP 客户端。只有完整验证授权、工具调用、长任务和重新连接流程后，才会将具体客户端标记为已支持。
积分与重试
轮询是安全的，重复生成不是重试。
MCP 与 Pixapi 其他功能共用同一账号余额和模型积分规则。当前价格以实时查价工具和价格页为准。
生成前调用 pixapi_get_pricing_and_balance，确认模型费用和可用余额。
pixapi_generate_image 会创建新任务，并按所选模型消耗对应积分。
pixapi_get_task 是只读工具。请持续轮询返回的 task_id，直到 completed 或 failed。
当前生成调用不支持幂等
重复调用 pixapi_generate_image 会创建另一项任务，并可能再次扣费。提交后请保存 task_id 并轮询；不要因为任务仍在处理中就自动重新提交。