Skip to main content
POST
Reserve a transcription node

Headers

X-API-Key
string

Compute/Grid API key with grid:write scope for prepaid credits.

Example:

"x402c_..."

Body

application/json
model
enum<string>
required
Available options:
whisper-1
transcription_protocol
enum<string>
required
Available options:
transcription-v1
request_id
string<uuid>
required

Stable canonical lowercase UUID v4 logical identity bound into reservation, sealed input, result, and billing.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
sample_rate
enum<integer>
required
Available options:
16000
channels
enum<integer>
required
Available options:
1
bits_per_sample
enum<integer>
required
Available options:
16
sample_count
integer
required

Duration and quote authority. The submit envelope and node independently bind and verify this count.

Required range: 1 <= x <= 960000
use_credits
boolean
required
model_revision
enum<string>
required

Exact immutable candidate pin; mismatches are rejected before reservation.

Available options:
5359861c739e955e79d9a303bcbc70fb988958b1
model_sha256
enum<string>
required

Exact immutable candidate pin; mismatches are rejected before reservation.

Available options:
1be3a9b2063867b937e64e2ec7483364a79917e157fa98c5d94b5c1fffea987b
language
string
default:auto
Pattern: ^(auto|[a-z]{2})$
node
string<uuid>

Optional eligible provider node id to pin.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
max_price
number

Maximum accepted quote in USD.

Response

Short-lived reservation and maximum quote. No audio was uploaded by this step.

reservation_token
string
required
request_id
string<uuid>
required
model
enum<string>
required
Available options:
whisper-1
model_revision
string
required

Immutable Hugging Face commit: 5359861c739e955e79d9a303bcbc70fb988958b1.

Pattern: ^[a-f0-9]{40}$
model_sha256
string
required

SHA-256 of the pinned model file.

Pattern: ^[a-f0-9]{64}$
transcription_protocol
enum<string>
required
Available options:
transcription-v1
sample_count
integer
required
Required range: 1 <= x <= 960000
language
string
required
Pattern: ^(auto|[a-z]{2})$
node_id
string<uuid>
required
node_x25519_pubkey
string
required

Base58 X25519 key used by the client to seal the PCM payload.

node_ed25519_pubkey
string
required

Base58 Ed25519 identity key used to verify the sealed result signature.

node_x25519_pubkey_sig
string
required

Node identity signature binding the current versioned X25519 key.

key_version
integer
required
Required range: x >= 0
tee_type
string | null
required
attestation_verified
boolean
required
expires_in_ms
integer
required
Required range: x >= 1
quote
object
required