API 개요 - Seyval

Seyval API를 사용하면 리포지토리 관리, 코드 분석 실행, 코드 실행, 연동 설정을 프로그래밍 방식으로 수행할 수 있습니다. 모든 엔드포인트는 HTTPS를 통한 JSON을 사용합니다.

기본 URL

https://api.seyval.dev

버전 관리

모든 리소스 엔드포인트에는 /v1 접두사가 붙습니다. OAuth 및 디스커버리 엔드포인트에는 버전이 없습니다.

인증

대부분의 엔드포인트에는 Bearer 토큰이 필요합니다. Authorization 헤더에 전달하세요:

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

대시보드 또는 API 키 엔드포인트를 통해 API 키를 생성하고 관리할 수 있습니다.

응답 형식

모든 응답은 JSON을 반환합니다. 성공적인 응답은 표준 HTTP 상태 코드를 사용합니다:

코드	의미
`200`	성공
`201`	리소스 생성됨
`204`	성공, 응답 본문 없음
`422`	유효성 검사 오류

오류 응답

유효성 검사 오류는 422 상태를 반환하며, 어떤 필드가 실패했는지에 대한 세부 정보가 포함됩니다:

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

run이 어떤 계산 자원을 사용했는지

run의 계산 자원은 두 개의 필드로 표현되며, 각각 다른 질문에 답합니다.

필드	답하는 질문
`compute_id`	어느 실행 대상인지 — `managed:<tier>` 또는 `byo:<uuid>`.
`compute_type`	실제로 실행된 machine의 종류.

매니지드 실행에서는 둘이 일치합니다(요청한 티어가 그대로 실제 자원이므로 compute_type은 그 티어, 예 gpu-h100). BYO 클러스터에서는 일치하지 않습니다. compute_type은 클러스터가 스스로 보고한 GPU 모델(sinfo의 GRES 타입, 예 nvidia_gb200)이며, 보고된 값이 없으면 unknown입니다. 따라서 고정된 값 집합이 아니라 자유 문자열입니다. run을 시작할 때 보내는 compute_type은 의미가 다릅니다. 그것은 무엇을 요청하는지이며, BYO 클러스터에서는 GPU 요청을 도출하는 데 쓰이는 호환 티어를 담습니다. 요청과 기록은 서로 다른 값이며, BYO에서는 일치하지 않습니다.

다운로드 URL

파일 내용을 돌려주는 엔드포인트(실행 로그 stdout_url / stderr_url, 실행 산출물 download_url)는 바이트 자체가 아니라 수명이 짧은 presigned URL을 반환합니다. 각 URL은 발급 시점부터 최대 1시간 동안만 유효하며, 로그 URL은 캐시를 통해 제공되므로 남은 시간이 그보다 짧을 수 있습니다. 이 URL을 저장하지 마세요. 저장해 둔 URL은 이후 Request has expired만 반환합니다. 대신 run_id(및 산출물 경로)를 저장하고, 파일이 실제로 필요한 시점에 새 URL을 발급받으세요.

# 다시 발급받아 같은 단계에서 내려받기
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

엔드포인트 그룹

사이드바를 사용하여 그룹별로 정리된 모든 사용 가능한 엔드포인트를 탐색하세요:

리포지토리 — 리포지토리 등록, 목록 조회 및 관리
리포지토리 파일 — 리포지토리 내 파일 탐색
코드 분석 — 코드 분석 시작, 모니터링 및 관리
코드 실행 — 코드 실행 및 실행 결과 조회
런 스트리밍 — SSE를 통한 실시간 stdout/stderr 로그 스트리밍
API 키 — API 키 생성 및 폐기
환경 변수 — 실행 환경 변수 관리
GitHub 연동 — GitHub 리포지토리 연결 및 관리
GitHub App Webhooks — push 및 pull request 이벤트를 수신하여 자동 분석 실행
OAuth 2.0 — 인가, 토큰 및 클라이언트 등록

​기본 URL

​버전 관리

​인증

​응답 형식

​오류 응답

​run이 어떤 계산 자원을 사용했는지

​다운로드 URL

​엔드포인트 그룹