Pular para o conteúdo principal
GET
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

X-On-Behalf-Of
string

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

Parâmetros de caminho

id
string
obrigatório

Identificador de prompt

Parâmetros de consulta

version
integer

Versão a ser recuperada — padrão para a versão ativa

Intervalo obrigatório: -9007199254740991 <= x <= 9007199254740991
variables
string

Mapa de chave-valor codificado em JSON para renderizar no template, por exemplo, {"name":"Alice"}

Resposta

200 - application/json

OK

id
string
obrigatório

Identificador único de prompt

object
any
obrigatório

Tipo de objeto

name
string
obrigatório

Nome do prompt legível por humanos

active_version
integer
obrigatório

Número da versão atualmente ativa

Intervalo obrigatório: -9007199254740991 <= x <= 9007199254740991
latest_version
integer
obrigatório

Número da versão mais recente

Intervalo obrigatório: -9007199254740991 <= x <= 9007199254740991
metadata
object
obrigatório

Pares de chave-valor de metadados personalizados

created_at
string<date-time>
obrigatório

Timestamp quando o prompt foi criado

updated_at
string<date-time>
obrigatório

Carimbo de data/hora em que o prompt foi atualizado pela última vez

active_template
string
obrigatório

O texto modelo para a versão solicitada

description
string

Descrição detalhada do prompt

rendered_template
string

O modelo com variáveis substituídas — presente apenas quando variáveis são fornecidas