市场
租用与驾驶
把一个已挂牌的机器人、计算机或仿真租用进一个会话。卖方的硬件实时加入;你的智能体(或者你自己,通过远程控制)来驾驶它。
租用进一个会话
该挂牌的设备必须处于 online 状态。租用会产生一笔预付费购买,把设备关联到你那个绑定了这笔购买的会话,并通知卖方的运行时进行连接。之后按挂牌费率按分钟计量(预付的起始区块不会被重复收费)。重试一个被中断的请求时,请保持相同的 Idempotency-Key;使用新的 key 会开始一次新的租用。
POST /threads/:id/rent-embodiment
# Rent a listed embodiment into a thread you can attach to.
curl https://api.commandagi.com/threads/$THREAD_ID/rent-embodiment ''
-H "Authorization: Bearer $COMMANDAGI_API_KEY" ''
-H "Idempotency-Key: $(uuidgen)" ''
-H "content-type: application/json" ''
-d '{ "listingId": "<listing-id>" }'
# → { "purchaseId": "...", "embodimentId": "...", "creditsPerMinute": 17 }驾驶它
一旦连接上,这台设备的行为就和会话中的其他设备一样:它的摄像头/屏幕会流式传输到剧场界面,智能体驱动它的执行器,你也可以接管远程控制。当会话变为闲置(或释放该设备)时,租约完成,卖方的收益从托管中释放,设备回到待机状态。
错误
device_offline——卖方的硬件未连接;insufficient_credits——请先充值;listing_at_capacity——所有单元都在使用中(或预约一个时间段)。挂牌页面上的浏览器流程会为你处理这些情况。