Saltar al contenido principal
POST
/
api
/
v1
/
llm
/
prompts
Python (SDK)
from openapi import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.prompts.create(name="Customer Support Classifier", template="Classify the following customer message into one of these categories: {{categories}}\n\nMessage: {{message}}", description="Classifies incoming customer messages by intent")

    # Handle response
    print(res)
{
  "id": "prompt_aa87e2b1112a455b8deabed784372198",
  "object": "prompt",
  "name": "Customer Support Classifier",
  "description": "Classifies incoming customer messages by intent",
  "active_version": 1,
  "latest_version": 1,
  "metadata": {},
  "created_at": "2026-03-15T10:30:00Z",
  "updated_at": "2026-03-15T10:30:00Z",
  "version": {
    "id": "pver_bb98f3c2223b566c9dfbcef895483209",
    "prompt_id": "prompt_aa87e2b1112a455b8deabed784372198",
    "version": 1,
    "object": "prompt.version",
    "template": "Classify the following customer message into one of these categories: {{categories}}\n\nMessage: {{message}}",
    "created_at": "2026-03-15T10:30:00Z"
  }
}

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

Cuerpo

application/json
name
string
requerido

Nombre de solicitud legible por humanos

Required string length: 1 - 255
template
string
requerido

El texto de la plantilla del aviso con marcadores de posición {{variable}}.

Required string length: 1 - 100000
description
string

Descripción detallada del aviso

Maximum string length: 2000
metadata
object

Pares de clave-valor de metadatos personalizados

Respuesta

201 - application/json

Está bien

id
string
requerido

Identificador de prompt único

object
any
requerido

Tipo de objeto

name
string
requerido

Nombre de solicitud legible por humanos

active_version
integer
requerido

Número de versión actualmente activa

Rango requerido: -9007199254740991 <= x <= 9007199254740991
latest_version
integer
requerido

Número de versión más reciente

Rango requerido: -9007199254740991 <= x <= 9007199254740991
metadata
object
requerido

Pares de clave-valor de metadatos personalizados

created_at
string<date-time>
requerido

Sello de tiempo cuando se creó la solicitud

updated_at
string<date-time>
requerido

Marca de tiempo cuando se actualizó por última vez el aviso

version
object
requerido

La versión inicial creada con este aviso.

description
string

Descripción detallada del aviso