API 레퍼런스
로그인
본문으로 건너뛰기

사용량과 비용

잡마다 과금 분과 금액이 기록됩니다, 콘솔과 API와 CSV로 날짜별, 워크스페이스별, API 키별 사용량과 비용을 보는 방법을 설명합니다

잡이 끝나면 실행 초를 1분 단위로 올려 과금하고 그 한 줄이 크레딧 원장에 남습니다, 사용량과 비용 화면과 API는 모두 이 원장 행을 읽습니다

어떻게 세나

항목규칙
과금 분billed_minutes = ceil(run_seconds / 60), 0초면 0분
금액과금 분 × 잡 시작 때 고정된 분당 요율(부가세 포함)
날짜잡이 끝나 정산된 시각의 UTC 날짜
포함API, CLI, MCP, GitHub Actions, 콘솔(플레이그라운드, 배치)에서 실행한 잡 전부
0원 잡플랫폼 오류로 끝난 잡은 0원이지만 잡 수에는 셉니다

방금 끝난 잡은 사용량에 반영되기까지 1분쯤 걸릴 수 있습니다

콘솔에서 보기

분석 메뉴 아래에 네 화면이 있습니다

화면경로내용
사용량/console/usage기간의 일별 비용 막대와 잡 목록(시작 시각, 실행 시간, 과금 분, 요율, 금액, 출처), CSV 내려받기
비용/console/cost이번 달, 지난달, 7일, 30일 범위의 합계와 일별 비용, 워크스페이스와 API 키와 러너(Xcode 버전)별 비중
준비 시간/console/usage/prepare날짜별 VM 준비, 소스 내려받기, 정리 시간의 평균과 p95, 준비 시간은 과금되지 않습니다
로그/console/workspaces/<워크스페이스>/logs잡 항목과 API 요청 항목(시각, 키, 메서드, 경로, 상태, 지연), 요청 항목은 30일 보존

소유자와 관리자는 조직 전체를, 개발자는 배정된 워크스페이스만 봅니다

CSV 내려받기

분석 → 사용량의 CSV 내려받기 또는 API 사용량 CSV로 잡 하나가 한 줄인 파일을 받습니다

date_utc,organization_id,workspace_id,workspace_name,api_key_id,api_key_name,source,job_id,repository,started_at_utc,ended_at_utc,run_seconds,billed_minutes,rate_usd_per_min,amount_usd,end_reason
  • UTF-8(BOM 포함), CRLF라 엑셀에서 바로 열립니다
  • 금액과 요율은 소수 6자리 USD입니다
  • 사람이 입력한 값(이름, 저장소)이 =, +, -, @로 시작하면 앞에 '를 붙여 수식 실행을 막습니다
  • 파일 이름은 xenoci-usage-<from>-<to>.csv입니다

API로 보기

curl "https://xenoci.com/api/runner/v1/usage?from=2026-10-01&to=2026-10-12&group_by=day" \
  -H "Authorization: Bearer $XENOCI_API_KEY"
엔드포인트내용
사용량 조회group_by=day, workspace, api_key, 최대 366일
사용량 CSV위의 CSV
비용 조회범위 종류(mtd, last_month, 7d, 30d, custom)와 러너별 묶음
로그 목록잡과 API 요청 로그
잡 조회잡 하나의 run_seconds, billed_minutes, amount_usd

API 키는 자기 워크스페이스만 봅니다, 콘솔 세션은 org_id를 보냅니다

CLI와 MCP로 보기

xenocast usage --from 2026-10-01 --to 2026-10-31 --by day
xenocast usage --by workspace --json
xenocast status job_2Qm7Xp9Lk4

잡이 끝나면 CLI가 실행 125초, 과금 3분, 금액 $0.1188, 남은 잔액 $19.8812 같은 한 줄을 남깁니다, MCP 서버의 usage 도구와 status 도구도 같은 값을 돌려줍니다

다음 단계