Skip to main content
POST
Python (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

Idempotency-Key
string
required
Required string length: 1 - 255
X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Body

application/json
generator_id
string
required
Required string length: 1 - 64
params
Params · object
required
output
OutputSpec · object
required
inputs
Inputs · object
limits
LimitsRequest · object | null

Each value may only be lower than the generator's default (api.md §3).

name
string | null
Maximum string length: 200
derived_from
string[]
Maximum array length: 100

Response

Successful Response

id
string
required
state
string
required
reason
Reason · object | null
required
generator
GeneratorRef · object
required
params
Params · object
required
params_hash
string
required
output
OutputRef · object
required
inputs
Inputs · object
required
counts
Counts · object | null
required
llm
LlmRef · object
required
limits
Limits · object
required

A run's budget: the generator's default_limits, or the effective ones as ctx.limits.

No defaults. Every number here is a bound the platform enforces and a caller can be billed against, so a generator that forgets to state one should not silently inherit a guess.

usage
Usage · object | null
required
job
JobRef · object | null
required
name
string | null
required
derived_from
string[]
required
created_by
CreatedBy · object
required
created_at
string<date-time>
required
started_at
string<date-time> | null
required
terminal_at
string<date-time> | null
required
duplicate_of
string | null