Coasty/

Developer API

Reference

What each endpoint costs in USD

Pricing

Pricing, at a glance

What each endpoint costs in USD

GET /v1/models + /machines/pricing
Runtime catalogs expose effective prices; billed calls reserve before work, settle once, and explicitly report any refund.

Requests are billed in US dollars from your prepaid API wallet. The charge is taken before the model runs. On a conclusive server-side failure, the API submits a refund; treat it as complete only when X-Credits-Refunded is present. Ambiguous provider mutations may retain the debit until reconciliation. Internally each request unit is $0.01 (the granularity behind every price below), but everything you pay and see is dollars. The table shows published base prices and defaults; test keys (sk-coasty-test-) always bill $0.00. The effective deployed CUA and task-step rate card is returned in the pricing object from GET /v1/models, so deployment probes can detect an operator override before sending billable work. Effective machine runtime prices come from GET /v1/machines/pricing.

EndpointCostNotes
POST /v1/predictManaged $0.05 · BYOK $0Managed base price plus published surcharges; provider-direct BYOK records tokens but debits no Coasty credits. Test auth requires an explicit provider-key header.
POST /v1/sessionsManaged $0.10 · BYOK $0One-time managed session creation; a BYOK session and its inherited steps are platform-cost exempt. Test auth requires an explicit provider-key header.
POST /v1/sessions/{id}/predictManaged $0.04 · BYOK $0Managed base step price plus surcharges; BYOK uses the session's provider key at zero Coasty cost.
POST /v1/groundManaged $0.03 · BYOK $0Managed coordinate grounding price; BYOK is platform-cost exempt.
POST /v1/parseFreeDeterministic, no model call.
POST /v1/tasksManaged meter · BYOK $0Managed steps use normal Run pricing and the ephemeral machine bills for actual runtime. BYOK steps debit $0 Coasty inference credits, while machine runtime and the caller's provider tokens remain billable.
POST /v1/runsManaged $0.05/step · BYOK $0Managed v3/v4/v5 steps are $0.05 ($0.08 on v1); live BYOK steps skip Coasty wallet charges. Managed-mode test runs are synthetic; test-auth BYOK intent returns 422.
POST /v1/workflows/runsManaged $0.05/step · BYOK $0Managed task steps use Run pricing; live BYOK task reservations and settlement are zero. Managed-mode test Workflows are synthetic; test-auth BYOK intent returns 422. Control-flow steps are always free.
POST /v1/machines/externalFreeEnrollment and driver transport are free. Managed Task/Workflow inference keeps normal pricing; BYOK inference costs 0 Coasty credits.
/v1/machines (Linux, running)$0.05/hr defaultPublished default; runtime metered per minute, rounded down. Starting, stopping, and restarting bill at the running rate.
/v1/machines (Windows, running)$0.09/hr defaultPublished default; runtime metered per minute, rounded down.
/v1/machines (stopped or suspended)$0.01/hr defaultPublished keep-alive default while a machine is parked. The creating, error, and terminated states bill nothing.
POST /v1/machines/{id}/snapshot$0.01 defaultPublished one-time default. Conclusive rejection is refunded; an ambiguous post-dispatch outcome retains the debit for reconciliation. Read effective values at GET /v1/machines/pricing.
/v1/machines/{id} per-call opsFreeActions, batch, browser, terminal, files, screenshot, and connection calls are never billed. Managed runtime and snapshots are the machine meters.
POST /v1/schedulesManaged meter · BYOK $0Managed schedules use the published wallet/runtime gates. Live BYOK bypasses Coasty billing. Managed-mode test schedules are synthetic; test-auth BYOK intent returns 422.

Surcharges

Predict and session-predict can incur all four fixed surcharges below. Ground can incur only the current-image HD fee, and session create has none. Each is an exact USD amount:

SurchargeCostApplies to
Trajectory screenshot+$0.02 eachPredict and session-predict only: each provider-visible screenshot in trajectory history.
High-resolution image+$0.01 eachPredict/session-predict: current plus provider-visible trajectory images. Ground: current image only. Strictly wider than 1280px or taller than 720px.
v1 engine+$0.03 per requestPredict and session-predict only when served by legacy v1 instead of v3/v4/v5.
Combined custom prompt+$0.01 per requestPredict and session-predict only when system_prompt plus trimmed instructions exceeds 500 characters. Exactly 500 is free; task instruction is excluded.

Machines

Managed-machine runtime is metered per minute and rounded down: $0.05/hr for a running Linux machine, $0.09/hr for a running Windows machine, and $0.01/hr while stopped or suspended. The starting, stopping, and restarting transitions bill at the running rate; the creating, error, and terminated states bill nothing, and TTL auto-destroy is free. Snapshots are a one-time $0.01 each, and every per-call operation (actions, batch, browser, terminal, files, screenshot, connection) is free. Provisioning requires a $0.20 wallet minimum, which is a gate, not a charge. If the wallet empties mid-flight the machine is automatically stopped, never destroyed, and resumes after you top up. The live rate card is always at GET /v1/machines/pricing.

External-machine enrollment and its heartbeat, observation, command-poll, and result transport are free and do not incur a VM runtime rate. Managed Task and Workflow inference keeps normal per-step pricing. Live-key BYOK records provider tokens and charges zero Coasty credits; test-key Task and Workflow execution remains deterministic sandbox and makes no provider call.

Schedule billing

Schedules have no per-fire fee. Managed schedules use the published API-wallet gate; BYOK schedules bypass create, run-now, and webhook wallet gates. For managed non-Unlimited accounts, execution is billed differently from everything else on this page: the published default charges scheduled agent runtime to your subscription credit balance at 10 consumer subscription credits per minute, with 20 credits required to start and a 6-hour timeout, not to this USD API wallet. Consumer subscription credits are quota units and do not inherit the Developer API wallet's fixed one-cent conversion. Unlimited bypasses the managed consumer-credit meter but retains managed API-wallet eligibility. BYOK opens no Coasty billing session and has no API-wallet eligibility gate. It reports credits_charged: 0; concurrency, persistent-machine, schedule, token, and abuse safeguards still apply. Live-key schedule execution can call and bill the selected provider. Managed-mode test-key schedule execution stays deterministic sandbox and makes no provider call; BYOK headers or provider metadata return 422 LLM_PROVIDER_UNSUPPORTED before execution without reading a stored provider key. Operator-effective gates, rates, timeouts, replay/dedup windows, body cap, and default webhook rate limit are exposed by GET /v1/models under pricing.schedules; use them in budget and signing guards. In schedule run-history records, credits_charged means consumer subscription-credit quota units, not API-wallet cents; it is zero for test, Unlimited-bypass, BYOK, and other non-billable runs and has no fixed USD conversion. Non-Unlimited managed schedules should keep both balances funded.

API reference — Coasty Computer Use API | Coasty - AI Computer-Use Agent