Saltar al contenido principal
POST
Iniciar una ejecución

Autorizaciones

Authorization
string
header
requerido

Envía Authorization: Bearer YOUR_API_KEY. La clave corresponde a una sola organización.

Encabezados

Idempotency-Key
string

Clave opcional, única por organización (1-255 caracteres ASCII imprimibles, por ejemplo un UUID). Reenviar una solicitud con la misma clave devuelve el resultado original en lugar de crear otro; usarla para una solicitud distinta devuelve 409 idempotency_key_reused.

Required string length: 1 - 255

Parámetros de ruta

id
string<uuid>
requerido

Id del benchmark.

Cuerpo

application/json
candidates
object[]
requerido

Lo que compara la ejecución, en orden de visualización.

Required array length: 1 - 10 elements
estimateToken
string
requerido

El estimateToken de la estimación, sin cambios.

Required string length: 1 - 8192
repeats
integer

Repeticiones por caso (LLM, 1-3). STT siempre 1.

Rango requerido: 1 <= x <= 3
versionNumber
integer

Versión publicada a ejecutar. Por defecto: la versión publicada actual (o el borrador si no hay nada publicado).

Rango requerido: x >= 1
draft
boolean

Ejecutar el borrador sin publicar en lugar de una versión publicada.

Respuesta

Respuesta correcta.

Una ejecución: qué compara, su estado, progreso y costo.

id
string
requerido
benchmarkId
string
requerido
number
number
requerido
status
enum<string>
requerido

awaiting_approval: espera a un propietario (supera el límite de gasto). rejected: un propietario la rechazó o la solicitud venció.

Opciones disponibles:
awaiting_approval,
queued,
running,
completed,
failed,
cancelled,
rejected
cancelRequested
boolean
requerido
trigger
enum<string>
requerido
Opciones disponibles:
ui,
api,
mcp
versionNumber
number | null
requerido
isDraftRun
boolean
requerido
repeats
number
requerido
totalCells
number
requerido
completedCells
number
requerido
passedCells
number
requerido
failedCells
number
requerido
erroredCells
number
requerido
skippedCells
number
requerido
candidates
object[]
requerido
results
object[]
requerido
estimatedCostUsd
number
requerido

USD.

costCapUsd
number | null
requerido

USD.

actualCostUsd
number | null
requerido

USD.

caseSetHash
string | null
requerido
failureReason
string | null
requerido
createdBy
string
requerido
createdByUser
object
requerido

Un miembro de la organización.

createdAt
string
requerido
startedAt
string | null
requerido
finishedAt
string | null
requerido
rescoredAt
string | null
requerido
approval
object | null
requerido

Una solicitud de aprobación de un propietario para una ejecución que supera el límite de gasto o el umbral.

publishedAsVersionNumber
number | null

Solo ejecuciones del borrador: la versión publicada después a partir del borrador sobre el que corrió esta ejecución (era el borrador en ese momento). Null mientras ese borrador sigue abierto, y en ejecuciones de una versión publicada.

{key}
any