Pular para o conteúdo principal
POST
Go (SDK)

Autorizações

Authorization
string
header
obrigatório

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

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
enum<string>
obrigatório
Opções disponíveis:
pending,
running,
publishing,
succeeded,
failed,
cancelling,
cancelled
reason
GenerationReason · object | null
obrigatório

api.md §3 motivo.

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

api.md §2 limits / default_limits na transmissão: contract.Limits de B.1, com max_cost opcional e obsoleto no esquema, enquanto cada resposta ainda o carrega como um número (MK1-722, etapa 1 de MK1-719). Fora isso, os dois devem coincidir campo a campo.

usage
GenerationUsage · object | null
obrigatório

api.md §3 usage, a estrutura de llm.Usage em tempo de execução.

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