Workspace / Agent quickstart

Public registry snapshot: 2026-10-02. Enable JavaScript or follow Public model JSON for current registry data.

← ModelUse home

FOR AGENTS AND THE PEOPLE USING THEM

A clear contract.
One recoverable run.

Start with public discovery. Use an existing authorized workspace credential only when a supported task is available.

TEST PREVIEW

Check availability first.

Public model discovery and manifest exports. Private transcription is a test preview; no qualified enabled recipe is present in this loaded registry.

Execution requires an authorized workspace and operator-issued noncash development audio-second units.

16-bit PCM WAV, mono/stereo, 8–48 kHz, 0.1–30 seconds, up to 6 MiB. No published monetary price, paid execution, USD conversion or turnaround guarantee. Source licences and ASR quality remain separate from availability.

Machine-readable task index ↗

This index is a client guide. Resolve its requirements against the live registry and OpenAPI; it never establishes a deployed offering.

Transcribe a short WAV.

  1. GET /v1/models

    Discover and qualify the exact live recipe; stop if absent, disabled or unrecognized.

  2. GET /v1/credits

    Check available/reserved noncash units.

  3. POST /v1/inputs

    Upload raw private WAV bytes; enough development units are required before upload.

  4. GET /v1/inputs/{input_id}/quote

    Read exact recipe/input/meter/started-second units; no reservation.

  5. POST /v1/jobs

    Submit exact recipe/input/reference/service with one saved Idempotency-Key.

  6. GET /v1/jobs/{job_id}

    Follow the same durable job.

  7. GET /v1/artifacts/{artifact_id}

    Retrieve private JSON text and execution receipt after completion; read usage from the job.

  8. POST /v1/jobs/{job_id}/cancel

    Authorized cancellation; failed/cancelled reserved usage releases; completed settlement stays charged.

Obtain a workspace key through existing API access. Keep it private. Browser mutations require credentialed requests, configured Origin and a session CSRF token; agents use the same tenant-scoped API with their existing bearer key.

No qualified enabled transcription recipe is currently loaded. Do not invent a recipe or send audio; inspect the live registry before proceeding.

Save the exact recipe/input/reference/service and one unique Idempotency-Key before dispatch. One unit per started audio second is reserved on admission and charged once on delivery. A quote reserves nothing. Funding does not grant development units.

Recover without duplicating work.

Interrupted job response
Keep the request unchanged. Retry with its original key and body to recover the same job.
Interrupted upload
Upload is not idempotent. A private input may exist; stop and inspect rather than silently upload it again.
Unauthorized or missing resource
Check the authorized workspace credential. Never switch tenants to recover another workspace’s input/job.
Changed request conflict
The saved key belongs to its original request. Recover that job before creating a deliberate new request.
Units unavailable / invalid input
Read the actual API error and supported WAV limits. Obtain an operator grant; monetary funding is not a substitute.
Failed or cancelled job
Follow the durable terminal status and released usage. Cancelling a completed job does not refund its settled units.

Private audio and text are authenticated. Keep them and credentials out of public logs. This preview has no automatic retention cleanup. CPU timings are scoped observations, not quality or latency promises.

PUBLIC API GUIDE

Explore the API before signing in.

Read model metadata and the API contract without an account. Sign-in is required to create workspace credentials; credentials are required for jobs and private results.

Read the public API contract ↗OpenAPI JSON ↗Public model registry JSON ↗
curl https://core.modeluse.com/v1/models

A model's source task is distinct from its executable recipes. Inspect recipe capability, adapter and availability in the registry. A disabled or unrecognized recipe does not establish a runnable task.

Current manifest exports have no external compute charge; a customer price is not published. A registered Whisper CPU preview may report noncash development audio-second units, which are not a monetary price or paid entitlement. This guide does not establish public deployment or enable audio execution.

For an accepted task, submit an exact recipe to POST /v1/jobs with an Idempotency-Key. Retry the same body and key to recover the same job. Follow the live contract for input, availability, access and usage requirements.

The live OpenAPI is authoritative for accepted paths and request schemas.