Skip to main content
POST
Python (SDK)

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

Idempotency-Key
string
obrigatório
Required string length: 1 - 255
X-On-Behalf-Of
string

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

Corpo

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

Cada valor pode ser apenas menor do que o padrão do gerador (api.md §3).

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

Resposta

Resposta Bem-Sucedida

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

O orçamento de uma execução: os default_limits do gerador, ou os efetivos como ctx.limits.

Sem padrões. Cada número aqui é um limite que a plataforma impõe e contra o qual um chamador pode ser cobrado, então um gerador que esquece de declarar um não deve herdá-lo silenciosamente por suposição.

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