Coasty Computer Use API es una interfaz HTTPS que permite ejecutar tareas autónomas sobre máquinas gestionadas, componer flujos complejos y, cuando se precisa un control más fino, recurrir a primitivas de predicción de bajo nivel. Toda la comunicación se realiza contra el endpoint https://coasty.ai/v1 y se autentica mediante la cabecera X-API-Key (también admite Authorization: Bearer). Las claves de prueba (sk-coasty-test-) nunca facturan y operan contra máquinas virtuales simuladas, lo que facilita el desarrollo y la integración continua antes de pasar a una clave real.
El nivel más alto de la API son las ejecuciones de tarea (POST /v1/runs): basta con indicar un machine_id y una descripción de la tarea, enviar un Idempotency-Key para evitar duplicados y el agente de Coasty se encarga de iterar hasta un estado terminal (succeeded, failed, cancelled o timed_out). Cada paso completado cuesta 0,05 USD con el motor v5 (0,08 USD con el motor v1 heredado) y los eventos se pueden seguir mediante sondeo, stream SSE con Last-Event-ID o webhooks firmados con un webhook_secret que se muestra una sola vez al crear la ejecución. Cuando una automatización requiere múltiples tareas, ramas, bucles, aprobaciones o salidas compartidas se recurre a los workflows.
Para equipos que necesitan gobernar el bucle de control, Coasty expone primitivas de predicción: sesiones con bucle de capturas, predict para un paso sin estado, grounding para coordenadas y parse para acciones estructuradas. La documentación incluye además indicaciones sobre gestión de claves, alcances (scopes), manejo de errores y modos de pausa para intervención humana, y está pensada para integrarse en pipelines de producción con buenas prácticas de seguridad y facturación transparente por uso.
