HTTP endpoints
Base URL, authentication, idempotency, and the public compute routes used by the CLI and direct integrations.
Base URL and authentication
https://api.amics.aiAuthorization: Bearer amics_sk_...
Content-Type: application/jsonUse a workspace API key. Do not put it in source, command arguments, or logs.
The complete request, response, and error schemas are published in the
OpenAPI document.
Read live GPU options
This request is read-only and does not acquire compute:
curl --fail-with-body https://api.amics.ai/v1/platform/compute/gpu-options \
--header @- \
--data '{"gpu_count":1,"minimum_gpu_memory_gb":24,"expected_duration_seconds":1800}' <<EOF
Authorization: Bearer $AMICS_API_KEY
Content-Type: application/json
EOFThe shell expands the API key into curl's standard input, not its process arguments. Keep shell tracing disabled anywhere secret input could be recorded.
The response contains independent provider-neutral options. Select a family using the workload's architecture and feature requirements before creating a snapshot or run.
Command execution
| Method and path | Purpose |
|---|---|
POST /v1/platform/compute/gpu-options | List supported GPU prices and live availability |
POST /v1/platform/compute/source-snapshots | Create or resume a source snapshot |
GET /v1/platform/compute/source-snapshots/{snapshot_id} | Inspect upload state |
PUT /v1/platform/compute/source-snapshots/{snapshot_id}/chunks/{chunk_index} | Upload a checksummed binary chunk |
POST /v1/platform/compute/runs | Accept a durable command run |
GET /v1/platform/compute/runs | List and filter durable runs |
GET /v1/platform/compute/runs/{run_id} | Inspect command and cleanup state |
GET /v1/platform/compute/runs/{run_id}/output | Read a bounded output page |
GET /v1/platform/compute/runs/{run_id}/output/stream | Follow newline-delimited output |
POST /v1/platform/compute/runs/{run_id}/cancel | Cancel one run generation |
POST /v1/platform/compute/runs requires an Idempotency-Key header. Preserve
the same key and body when recovering from a lost response.
Set constraints.storage_gb when creating a run, and storage_gb when
requesting GPU options or recommendations. The value is an integer from 1 to
10,000, defaults to 50 GB, and is included in the hourly price ceiling. A
provided or warm machine must already have enough disk; it is not resized.
Source chunks use application/octet-stream and
X-Amics-Chunk-Sha256. Output cursors are opaque and must be returned
unchanged.
Run list and detail responses include attributed_spend_microusd after metered
charges settle. Warm idle time is excluded from per-run attribution but remains
billed to the lease; overlapping commands share the lease interval.
Reusable compute
| Method and path | Purpose |
|---|---|
GET /v1/platform/compute/leases | List reusable compute leases |
POST /v1/platform/compute/leases | Create a reusable compute lease |
GET /v1/platform/compute/leases/{lease_id} | Inspect a compute lease |
PATCH /v1/platform/compute/leases/{lease_id} | Rename a compute lease |
POST /v1/platform/compute/leases/{lease_id}/stop | Stop a compute lease |
DELETE /v1/platform/compute/leases/{lease_id} | Stop a compute lease |
Historical /v1/platform/training routes remain deprecated compatibility
aliases for released clients. New integrations should use compute leases.
File uploads
Upload sessions target an absolute file path under the running compute's source
or workspace. Create a session with the file size, send sequential binary
chunks with X-Amics-Chunk-Sha256, then complete it with the full-file
SHA-256. Session routes require the run_id, generation, and attempt_id
returned by session creation; deleting a session cancels the upload without
stopping compute.
| Method and path | Purpose |
|---|---|
POST /v1/platform/compute/leases/{lease_id}/uploads | Create an upload session |
PUT /v1/platform/compute/leases/{lease_id}/uploads/{upload_id}/chunks/{chunk_index} | Send one binary upload chunk |
POST /v1/platform/compute/leases/{lease_id}/uploads/{upload_id}/complete | Verify and atomically publish the file |
DELETE /v1/platform/compute/leases/{lease_id}/uploads/{upload_id} | Cancel an upload session |
For reusable multi-node leases, gpu_count, cpu_count, memory_gb, and
storage_gb describe each identical node. Lease responses include explicit
total_* resource fields. estimated_hourly_price_usd_per_node includes one
node's compute and attached storage; estimated_hourly_price_usd is the retail
rate for the full cluster. Credit authorization, metering, and GPU quota use
the full-cluster values.
The CLI and direct HTTP API are the supported integrations. A production Amics MCP server is not part of the current contract.