Skip to main content
POST
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

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>.

Encabezados

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

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

Cuerpo

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

Cada valor solo puede ser inferior al valor predeterminado del generador (api.md §3).

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

Respuesta

Respuesta Exitosa

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

El presupuesto de una ejecución: los default_limits del generador, o los efectivos como ctx.limits.

Sin valores predeterminados. Cada número aquí es un límite que la plataforma aplica y contra el que se puede facturar a quien llama, así que un generador que olvida especificar uno no debería heredar silenciosamente una suposición.

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