Marketplace
Rentar y conducir
Renta un robot, computadora o simulación publicados hacia un hilo. El hardware del vendedor se une en vivo; tu agente (o tú, por control remoto) lo conduce.
Rentar hacia un hilo
El dispositivo del anuncio debe estar online. Rentar implica una compra con pago por adelantado, adjunta el dispositivo a tu hilo vinculado a esa compra, y le indica al runtime del vendedor que se conecte. Luego mide por minuto a la tarifa del anuncio (el bloque inicial prepagado no se cobra dos veces). Conserva la misma Idempotency-Key al reintentar una solicitud interrumpida; una key nueva inicia una renta nueva.
# 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 }Condúcelo
Una vez conectado, el dispositivo se comporta como cualquier otro en el hilo: su cámara/pantalla se transmite al teatro, el agente maneja sus actuadores, y puedes tomar el control remoto. Cuando el hilo queda inactivo (o libera el dispositivo), el arrendamiento se completa, las ganancias del vendedor se liberan de la garantía, y el dispositivo vuelve a espera.
Errores
device_offline — el hardware del vendedor no está conectado; insufficient_credits — recarga saldo primero; listing_at_capacity — todas las unidades en uso (o reserva una ventana). El flujo del navegador en la página de un anuncio maneja esto por ti.