Referencia de la API de Coasty Computer Use

Fuentes: API reference — Coasty Computer Use API

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.