> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Crear un Run > Ejecuta un endpoint con la entrada preparada desde Inspect. Glasser comprueba la Policy de tu API Key y reserva fondos antes de crear un Run. * **200:** el Run ha terminado. Comprueba su estado, la respuesta del proveedor de datos y el cargo. * **202:** un Run asíncrono sigue en curso. Usa [Get a Run](https://glasser.ai/docs/es/api-reference/runs/get.md) para comprobar su resultado. Un Run terminado puede contener un error del proveedor de datos. Usa el mismo `Idempotency-Key` y los mismos parámetros de ejecución al reintentar. ## OpenAPI ````yaml /openapi.es.json post /v1/runs openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: >- Una API Key, sin contrato, con pago por llamada, para APIs de pago adquiridas al por mayor. Cada respuesta incluye x-request-id; cada cuerpo de error incluye el mismo sobre. servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/runs: post: tags: - Runs summary: Ejecutar un Endpoint description: >- Ejecuta un Endpoint con una entrada nativa del proveedor de datos preparada a partir de Inspect. Glasser comprueba la Policy de tu Key y reserva el cargo máximo antes de crear un Run. Un rechazo no crea ningún Run ni genera ningún cargo. Reutiliza la misma Idempotency-Key y los mismos parámetros de ejecución para reintentarlo sin una segunda ejecución. - **200:** el Run ha finalizado. Comprueba su estado, la respuesta del proveedor de datos y el cargo. - **202:** un Run asíncrono aún está en progreso. Usa Get Run para leer su resultado. Los Endpoints síncronos siempre devuelven un Run finalizado dentro de su timeout_ms publicado. COMPLETED puede incluir un error del proveedor de datos; comprueba provider_response. El estado y el cargo son independientes: un Run FAILED puede tener un cargo. operationId: runs-create parameters: - name: idempotency-key in: header schema: type: string minLength: 1 description: >- Genere un valor único para cada ejecución prevista (se recomienda un UUID). Reintente con la misma clave y los mismos parámetros de ejecución para recuperar el Run original sin un segundo cargo. Cambiar los parámetros de ejecución con la misma clave devuelve 409; cambiar task_id o metadata no actualiza el Run original. required: true requestBody: content: application/json: schema: type: object properties: provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ input: type: object description: >- Entrada nativa del proveedor de datos. Constrúyela a partir de input_schema, devuelto por Inspect. endpoint_version: anyOf: - type: integer exclusiveMinimum: 0 description: >- Selecciona una versión compatible u omítela para usar la predeterminada. Las actualizaciones compatibles conservan la versión; las versiones no disponibles o retiradas devuelven 409. Una versión no fija el Price: los Runs nuevos usan el Price vigente en el momento de admisión y los Runs aceptados lo conservan hasta la liquidación. - type: 'null' task_id: anyOf: - type: string description: >- La tarea a la que pertenece este Run, obtenida de una respuesta de búsqueda del catálogo. Solo sirve para agrupar: nunca afecta al enrutamiento, el precio ni la idempotencia. - type: 'null' metadata: anyOf: - anyOf: - type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ - {} description: >- Campos de seguimiento opcionales, devueltos en el Run y disponibles como filtros. Nunca se envían al proveedor de datos ni afectan al enrutamiento, Price o la idempotencia. - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar con una letra y tener como máximo 40 caracteres. - Valores: cadenas de 1–500 caracteres. - user_id: el ID opaco de tu usuario final, nunca su dirección de correo electrónico ni su nombre. Las entradas no válidas se descartan por completo, no se truncan. La solicitud continúa y el Run devuelve los campos que se almacenaron. - type: 'null' required: - provider - endpoint additionalProperties: false required: true responses: '200': description: 'un Run terminal: COMPLETED, FAILED o STOPPED' content: application/json: schema: type: object properties: id: type: string run_url: type: string description: >- Abra este Run en la consola. Requiere pertenecer a un Workspace. provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED o RUNNING: todavía está en curso. COMPLETED: hay una respuesta del proveedor de datos disponible, incluidas las respuestas que no sean 2xx. FAILED: consulta `failure`. STOPPED: detenido antes del envío. Lea charge_usd por separado del estado. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: >- Motivo por el que falló el Run. Solo es distinto de null cuando el estado es FAILED. input: type: object output: {} provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: >- Estado HTTP devuelto por el proveedor de datos. Compruébelo incluso cuando el Run esté COMPLETED. error: anyOf: - {} - type: 'null' required: - http_status additionalProperties: false - type: 'null' description: >- Solo es distinto de null cuando el estado es COMPLETED. - Para respuestas 2xx, output contiene JSON nativo del proveedor de datos (con cualquier estructura) o null si el cuerpo está vacío. - Para respuestas que no sean 2xx, error contiene el cuerpo del error del proveedor de datos y output es null. Los campos sensibles se eliminan de ambos cuerpos. charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. - type: 'null' description: >- Cargo final como cadena decimal exacta en USD. Es null mientras el estado sea QUEUED o RUNNING. Un Run FAILED puede tener un cargo distinto de cero según el Price del endpoint. charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: >- Cláusula de Price utilizada para calcular el cargo. Es null antes de la liquidación o cuando no se intentó contactar con ningún proveedor de datos. stoppable: type: boolean description: >- Indica si actualmente se puede aceptar una solicitud de detención. Esto no garantiza que el Run pueda detenerse antes del envío. stop_requested_at: anyOf: - type: string description: Marca de tiempo UTC ISO-8601 format: date-time - type: 'null' description: >- Cuándo se solicitó la detención. El Run aún puede continuar si el dispatch ya había comenzado. created_at: type: string description: Marca de tiempo UTC ISO-8601 format: date-time started_at: anyOf: - type: string description: Marca de tiempo UTC ISO-8601 format: date-time - type: 'null' completed_at: anyOf: - type: string description: Marca de tiempo UTC ISO-8601 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: >- Tus campos de seguimiento almacenados. Úsalos para filtrar Runs. Nunca se envían al proveedor de datos ni afectan al enrutamiento, Price o la idempotencia. - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar con una letra y tener como máximo 40 caracteres. - Valores: cadenas de 1–500 caracteres. - user_id: el ID opaco de tu usuario final, nunca su dirección de correo electrónico ni su nombre. required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata additionalProperties: false '202': description: 'un Run en curso: QUEUED o RUNNING' content: application/json: schema: type: object properties: id: type: string run_url: type: string description: >- Abre este Run en la consola. Requiere pertenencia a Workspace. provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED o RUNNING: aún en progreso. COMPLETED: hay una respuesta del proveedor de datos disponible, incluidas las respuestas no 2xx. FAILED: consulta `failure`. STOPPED: detenido antes del dispatch. Lee charge_usd por separado del estado. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: >- Motivo por el que falló el Run. Solo es distinto de null cuando el estado es FAILED. input: type: object output: {} provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: >- Estado HTTP devuelto por el proveedor de datos. Compruébalo incluso cuando el Run está COMPLETED. error: anyOf: - {} - type: 'null' required: - http_status additionalProperties: false - type: 'null' description: >- Solo es distinto de null cuando el estado es COMPLETED. - Para respuestas 2xx, output contiene JSON nativo del proveedor de datos (de cualquier forma) o null si el cuerpo está vacío. - Para respuestas no 2xx, error contiene el cuerpo del error del proveedor de datos y output es null. Los campos sensibles se eliminan de ambos cuerpos. charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma usando aritmética decimal o escala por 10^6; nunca uses números de coma flotante. - type: 'null' description: >- Cargo final como cadena decimal exacta en USD. Es null mientras está QUEUED o RUNNING. Un Run FAILED puede tener un cargo distinto de cero según el Price del Endpoint. charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: >- Cláusula de Price utilizada para calcular el cargo. Es null antes de la liquidación o cuando no se realizó ningún intento con el proveedor de datos. stoppable: type: boolean description: >- Indica si actualmente se puede aceptar una solicitud de detención. Esto no garantiza que el Run pueda detenerse antes del dispatch. stop_requested_at: anyOf: - type: string description: Marca de tiempo UTC ISO-8601 format: date-time - type: 'null' description: >- Cuándo se solicitó la detención. El Run aún puede continuar si el dispatch ya había comenzado. created_at: type: string description: Marca de tiempo UTC ISO-8601 format: date-time started_at: anyOf: - type: string description: Marca de tiempo UTC ISO-8601 format: date-time - type: 'null' completed_at: anyOf: - type: string description: Marca de tiempo UTC ISO-8601 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: >- Tus campos de seguimiento almacenados. Úsalos para filtrar Runs. Nunca se envían al proveedor de datos ni afectan al enrutamiento, Price o la idempotencia. - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar con una letra y tener como máximo 40 caracteres. - Valores: cadenas de 1–500 caracteres. - user_id: el ID opaco de tu usuario final, nunca su dirección de correo electrónico ni su nombre. required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata additionalProperties: false '400': description: ValidationFailed | IdempotencyKeyRequired content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/IdempotencyKeyRequiredEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '402': description: InsufficientBalance content: application/json: schema: $ref: '#/components/schemas/InsufficientBalanceEncoded' '403': description: EndpointNotPermitted | Forbidden content: application/json: schema: anyOf: - $ref: '#/components/schemas/EndpointNotPermittedEncoded' - $ref: '#/components/schemas/ForbiddenEncoded' '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/NotFoundEncoded' '409': description: IdempotencyConflict | EndpointVersionMismatch content: application/json: schema: anyOf: - $ref: '#/components/schemas/IdempotencyConflictEncoded' - $ref: '#/components/schemas/EndpointVersionMismatchEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' '503': description: ServiceUnavailable content: application/json: schema: $ref: '#/components/schemas/ServiceUnavailableEncoded' security: - bearer: [] components: schemas: ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false IdempotencyKeyRequiredEncoded: type: object properties: error: type: object properties: code: type: string enum: - idempotency_key_required message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false InsufficientBalanceEncoded: type: object properties: error: type: object properties: code: type: string enum: - insufficient_balance message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false EndpointNotPermittedEncoded: type: object properties: error: type: object properties: code: type: string enum: - endpoint_not_permitted message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false NotFoundEncoded: type: object properties: error: type: object properties: code: type: string enum: - not_found message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false IdempotencyConflictEncoded: type: object properties: error: type: object properties: code: type: string enum: - idempotency_conflict message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false EndpointVersionMismatchEncoded: type: object properties: error: type: object properties: code: type: string enum: - endpoint_version_mismatch message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ServiceUnavailableEncoded: type: object properties: error: type: object properties: code: type: string enum: - service_unavailable message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.