Build with Scalarware.

API reference

Every Scalarware API is one base URL and one bearer token. Requests and responses are JSON; language inference follows the OpenAI chat-completions schema so existing clients work unchanged.

Base URL

https://scalarware.com/api/v1

API groups

Authentication

Authorization: Bearer $SCALARWARE_API_KEY

Keys carry scopes. inference:read and inference:write cover models, chat and media; compute:read and compute:write cover GPUs. A call outside a key's scopes returns 401.

Billing

Requests are metered against the workspace balance at the published rate with no Scalarware markup. A request is priced before it runs and refused with 402 insufficient_balance when the workspace cannot cover it. GPU runtime is charged every minute a machine is up.

Your first direct API call

You do not need Claude, Codex, a Scalarware skill, or a rented GPU. Every media operation is available through normal authenticated HTTP.

export SCALARWARE_API_KEY="scalar_live_..."

curl "https://scalarware.com/api/v1/catalog/search?modality=image" \
  -H "Accept: application/json"

curl "https://scalarware.com/api/v1/images/generations" \
  -H "Authorization: Bearer $SCALARWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {"prompt": "Editorial product photo", "resolution": "1K"}
  }'

Authentication

Send your Scalarware key as a Bearer token from a server, agent runtime, or private GPU. Never put it in browser JavaScript or a public repository.

Authorization: Bearer $SCALARWARE_API_KEY

Use Scalarware with an AI

Agent integration is optional. Direct API users can skip this entire section.

https://docs.scalarware.com/llms-full.txt

curl -fsSL https://scalarware.com/skills/scalarware-media/install.sh | bash

Media model catalog

Returns only Scalarware-supported media models. Each object includes its exact JSON input schema, current price tiers, billing metric, and pricing guard.

curl "https://scalarware.com/api/v1/catalog/search?modality=video&q=wan"

OpenAI-compatible language models

List normalized live routes, then call a model using the familiar chat-completions schema. Scalarware keeps route selection private and supports streamed responses.

curl "https://scalarware.com/api/v1/chat/completions" \
  -H "Authorization: Bearer $SCALARWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zai-org/GLM-5",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": false
  }'

Discover live GPU offers

Returns normalized, supplier-neutral GPU capacity. Re-query immediately before requesting a deployment because availability and hourly rates can move.

curl "https://scalarware.com/api/v1/compute/offers" \
  -H "Accept: application/json"

Quote, launch, inspect, destroy

Deployment mutations use the signed-in workspace session. A quote reserves a specific eligible offer for five minutes; launch requires the customer's SSH public key and an explicit confirmation.

curl "https://scalarware.com/api/v1/deployments/quote" \
  -H "Content-Type: application/json" \
  -d '{"template_id":"ltx-2.5","runtime_hours":4}'

Keys, wallet, and usage

These endpoints use the signed-in workspace session. API key tokens are shown once at creation.

Generate or edit an image

curl "https://scalarware.com/api/v1/images/generations" \
  -H "Authorization: Bearer $SCALARWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "input": {"prompt": "A minimal campaign poster", "quality": "medium", "number_of_images": 1},
    "wait_seconds": 10,
    "cancel_after_seconds": 300
  }'

Generate or transform video

curl "https://scalarware.com/api/v1/videos/generations" \
  -H "Authorization: Bearer $SCALARWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3",
    "input": {"prompt": "A cinematic aerial shot over the coast", "duration": 5, "resolution": "1080p", "aspect_ratio": "16:9"},
    "cancel_after_seconds": 1800
  }'

For image-to-video, use the model’s URI input field with an HTTPS file URL. Kling Motion Control requires both an image and a reference video.

Poll, cancel, and download

Image and video jobs share one lifecycle. Every operation requires the same Scalarware key that created the job.

curl "https://scalarware.com/api/v1/media/jobs/$JOB_ID" \
  -H "Authorization: Bearer $SCALARWARE_API_KEY"

{
  "id": "media_...",
  "status": "succeeded",
  "output": [{"index": 0, "url": "/api/v1/media/jobs/media_.../output/0"}],
  "price": {"currency": "USD", "estimated_microusd": 500000, "billed_microusd": 500000}
}

Public-rate billing

Before a job starts, Scalarware calculates the maximum supported cost and reserves it from the wallet. After completion, the final cost is settled from output images or video seconds and unused credit is released.

Errors

Scalarware returns stable error envelopes and does not forward raw provider responses.

{
  "error": {
    "code": "pricing_refresh_required",
    "message": "Current public pricing could not be verified. No prediction was created."
  }
}