Descripción general de la API

La API de Seyval te permite gestionar repositorios, ejecutar análisis de código, ejecutar código y configurar integraciones de forma programática. Todos los endpoints utilizan JSON sobre HTTPS.

URL base

https://api.seyval.dev

Versionado

Todos los endpoints de recursos llevan el prefijo /v1. Los endpoints de OAuth y descubrimiento no tienen versión.

Autenticación

La mayoría de los endpoints requieren un token Bearer. Pásalo en el encabezado Authorization:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.seyval.dev/v1/repositories

Puedes crear y gestionar claves de API desde el panel de control o a través de los endpoints de claves de API.

Formato de respuesta

Todas las respuestas devuelven JSON. Las respuestas exitosas utilizan códigos de estado HTTP estándar:

Código	Significado
`200`	Éxito
`201`	Recurso creado
`204`	Éxito sin cuerpo de respuesta
`422`	Error de validación

Respuestas de error

Los errores de validación devuelven un estado 422 con detalles sobre qué campos fallaron:

{
  "detail": [
    {
      "loc": ["body", "field_name"],
      "msg": "description of the error",
      "type": "error_type"
    }
  ]
}

Qué cómputo usó una ejecución

Dos campos describen el cómputo de una ejecución y responden a preguntas distintas:

Campo	Pregunta que responde
`compute_id`	Qué destino — `managed:<tier>` o `byo:<uuid>`.
`compute_type`	Qué tipo de máquina ejecutó realmente.

En una ejecución gestionada ambos coinciden: obtienes el tier que pediste, así que compute_type es ese tier (gpu-h100). En un clúster BYO no coinciden. compute_type indica el modelo de GPU que el propio clúster declaró —el tipo GRES de sinfo, por ejemplo nvidia_gb200— o unknown si el clúster no declaró ninguno. Por eso es una cadena libre, no un conjunto fijo de valores. El compute_type que envías al iniciar una ejecución significa otra cosa: es lo que solicitas y, en un clúster BYO, lleva un tier de compatibilidad usado para derivar la petición de GPU. Solicitar y registrar son valores distintos, y en BYO difieren.

URLs de descarga

Los endpoints que devuelven el contenido de archivos —los registros de una ejecución (stdout_url / stderr_url) y sus resultados (download_url)— devuelven URLs prefirmadas de vida corta en lugar de los bytes. Cada una es válida como máximo una hora desde su emisión, y las URLs de registros se sirven desde una caché, por lo que el tiempo restante puede ser menor. No almacenes estas URLs: una URL guardada solo devolverá Request has expired. Guarda en su lugar el run_id (y la ruta del archivo) y solicita una URL nueva cuando realmente necesites el archivo:

# Reemitir y descargar en el mismo paso
curl -sSL "$(curl -sS -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.seyval.dev/v1/runs/RUN_ID | jq -r .stdout_url)" -o stdout.txt

Grupos de endpoints

Usa la barra lateral para explorar todos los endpoints disponibles, organizados por grupo:

Repositorios — registrar, listar y gestionar repositorios
Archivos de repositorio — explorar archivos dentro de un repositorio
Análisis de código — iniciar, monitorear y gestionar análisis de código
Ejecución de código — ejecutar código y obtener resultados de ejecución
Streaming de ejecución — transmitir logs de stdout/stderr en tiempo real vía SSE
Claves de API — crear y revocar claves de API
Variables de entorno — gestionar variables de entorno para la ejecución
Integración con GitHub — conectar y gestionar repositorios de GitHub
GitHub App Webhooks — recibir eventos push y pull request para análisis automatizado
OAuth 2.0 — autorización, tokens y registro de clientes

​URL base

​Versionado

​Autenticación

​Formato de respuesta

​Respuestas de error

​Qué cómputo usó una ejecución

​URLs de descarga

​Grupos de endpoints