智能体

模型与你的密钥

每个智能体都运行在一个你从后端无关的注册表中选择的模型上。可以在前沿模型和开放模型之间路由，按任务混用它们，或者带上自己的供应商密钥——托管模型上的用量按透传计费，不加价。

选择一个模型

创建会话时传入一个 modelId（或在已保存的智能体上设置它）。这个注册表覆盖了主流供应商——OpenAI、Anthropic、Google——以及运行在快速无服务器后端上的开放模型。在 GET /models 查看实时目录。

POST /threads

# Any thread or agent picks a model by id.
curl https://api.commandagi.com/threads ''
  -H "Authorization: Bearer $COMMANDAGI_API_KEY" ''
  -d '{ "title": "…", "modelId": "anthropic/claude-sonnet-5" }'

带上你自己的密钥

连接你自己的供应商账户，CommandAGI 会通过它进行路由——可以是 OpenAI、Anthropic 或 OpenRouter 的密钥，也可以是任何兼容 OpenAI 的端点（你自己的基础 URL）。你的密钥在静态存储时会被加密，且只用于服务你的会话；你的供应商会直接向你收费，CommandAGI 只计量平台的机器时间。

GET/models对你可用的模型目录。

POST/model-providers添加一个供应商连接（密钥 + 可选的基础 URL）。

GET/me/model-providers你已连接的供应商。

托管计费

对于托管模型（没有你自己的密钥），推理按透传计费——你通过积分余额按调用次数支付供应商的 token 价格，与机器的按分钟费率一并计量。没有按 token 的加价；平台收取的只是智能体运行所依托的算力费用。参见账单。

内置感知能力

无论你选择哪个对话模型，CommandAGI 都会加上它自己的计算机使用感知——把屏幕上原始的像素转换成有类型、结构化的界面，让模型针对元素进行推理，而不只是针对一张图片。这正是让一个通用模型能够可靠地点击真实软件的原因；你不需要配置它，它是整个循环的一部分。