Skip to main content
GET
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

X-On-Behalf-Of
string

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

Parámetros de ruta

generation_id
string
requerido

Respuesta

Respuesta Exitosa

registro de generación de api.md §3. Construido a partir del campo de la fila campo por campo, nunca from_attributes: la fila también lleva el digest de la imagen (architecture.md §2.15).

id
string
requerido
state
enum<string>
requerido
Opciones disponibles:
pending,
running,
publishing,
succeeded,
failed,
cancelling,
cancelled
reason
GenerationReason · object | null
requerido

api.md §3 reason.

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

api.md §2 limits / default_limits en el wire: contract.Limits de B.1, con max_cost opcional y obsoleto en el esquema mientras que cada respuesta aún lo incluye como un número (MK1-722, paso 1 de MK1-719). Ambos deben coincidir en todo lo demás, campo por campo.

usage
GenerationUsage · object | null
requerido

api.md §3 usage, la forma de llm.Usage en tiempo de ejecución.

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