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

비용 조회

기간의 비용 합계와 일별 막대, 워크스페이스나 API 키나 러너별 묶음을 돌려줍니다

GET /v1/cost

인증

방식허용조건
API 키 (Authorization: Bearer xci_live_…)가능키 권한 read (run 키도 가능)
콘솔 세션 쿠키가능조직 역할 owner, admin, developer
  • 사용량 조회와 같은 원장 행을 씁니다, 범위 규칙도 같습니다
  • group_by는 day, workspace, api_key, runner를 쉼표로 이어 여러 개 줄 수 있고 day는 항상 daily로 돌려줍니다

매개변수

이름위치타입필수설명
org_id쿼리string콘솔 세션은 필수, API 키는 무시(키의 조직)
range쿼리mtd | last_month | 7d | 30d | custommtd는 이번 달 1일부터 오늘, last_month는 지난 달력 월, 7d와 30d는 오늘 포함 최근 7일과 30일, custom은 from과 to(둘 다 필수, 최대 366일), 모두 UTC, 기본 "mtd"
from쿼리dateUTC 날짜, 포함
to쿼리dateUTC 날짜, 포함
group_by쿼리stringday, workspace, api_key, runner를 쉼표로 이어서, day는 항상 daily로 돌아옵니다, 기본 "day"
workspace_id쿼리string콘솔 세션은 워크스페이스가 필요한 곳에서 필수, API 키는 생략하거나 키의 워크스페이스와 같아야 합니다
api_key_id쿼리string이 키의 잡만

응답

200

필드타입항상설명
organization_idstring항상조직 ID
rangemtd | last_month | 7d | 30d | custom항상기간 종류
fromdate항상시작 날짜(UTC)
todate항상끝 날짜(UTC)
group_byarray<day | workspace | api_key | runner>항상묶음 기준
totalobject항상기간 합계
total.keystring항상groupby에 따라 UTC 날짜(YYYY-MM-DD), workspaceid 또는 apikeyid
total.labelstring사람이 읽는 이름, null 가능
total.jobsinteger항상잡 수
total.billed_minutesinteger항상과금 분 합
total.amount_micro_usdinteger항상금액 합(µUSD), 최소 0
total.amount_usdstring항상같은 금액의 USD 문자열(소수 6자리), 형식 ^-?[0-9]+\.[0-9]{6}$
dailyarray<object>항상날짜별 금액, 0인 날 포함
daily[].keystring항상groupby에 따라 UTC 날짜(YYYY-MM-DD), workspaceid 또는 apikeyid
daily[].labelstring사람이 읽는 이름, null 가능
daily[].jobsinteger항상잡 수
daily[].billed_minutesinteger항상과금 분 합
daily[].amount_micro_usdinteger항상금액 합(µUSD), 최소 0
daily[].amount_usdstring항상같은 금액의 USD 문자열(소수 6자리), 형식 ^-?[0-9]+\.[0-9]{6}$
groupsobject항상요청한 group_by별 묶음
groups.workspacearray<object>워크스페이스
groups.api_keyarray<object>키 없이 실행한 콘솔과 플레이그라운드 잡은 키 none으로 묶입니다
groups.runnerarray<object>키는 러너 ID macos-m4:xcode-<버전>, 잡이 고른 Xcode로 나눕니다
csv_urlstring항상같은 조건의 CSV 상대 URL
{
  "organization_id": "org_7Kq2m9ZtP3",
  "range": "mtd",
  "from": "2026-10-01",
  "to": "2026-10-12",
  "group_by": [
    "day",
    "workspace"
  ],
  "total": {
    "key": "2026-10-12",
    "label": "2026-10-12",
    "jobs": 4,
    "billed_minutes": 12,
    "amount_micro_usd": 475200,
    "amount_usd": "0.475200"
  },
  "daily": [
    {
      "key": "2026-10-12",
      "label": "2026-10-12",
      "jobs": 4,
      "billed_minutes": 12,
      "amount_micro_usd": 475200,
      "amount_usd": "0.475200"
    }
  ],
  "groups": {
    "workspace": [
      {
        "key": "2026-10-12",
        "label": "2026-10-12",
        "jobs": 4,
        "billed_minutes": 12,
        "amount_micro_usd": 475200,
        "amount_usd": "0.475200"
      }
    ],
    "api_key": [
      {
        "key": "2026-10-12",
        "label": "2026-10-12",
        "jobs": 4,
        "billed_minutes": 12,
        "amount_micro_usd": 475200,
        "amount_usd": "0.475200"
      }
    ],
    "runner": [
      {
        "key": "2026-10-12",
        "label": "2026-10-12",
        "jobs": 4,
        "billed_minutes": 12,
        "amount_micro_usd": 475200,
        "amount_usd": "0.475200"
      }
    ]
  },
  "csv_url": "/api/runner/v1/cost/export.csv?range=mtd"
}

오류

HTTP코드다시 시도뜻
400invalid_request아니오본문이나 쿼리가 검증에 실패했습니다, error.details.fields에 문제 필드가 있습니다
401api_key_required아니오API 키 엔드포인트에 Authorization: Bearer 헤더가 없습니다
401api_key_revoked_leaked아니오공개 유출 신고로 자동 폐기된 키입니다, 새 키를 발급하세요
401invalid_api_key아니오모르는 키이거나 폐기, 만료, 체크섬 불일치입니다(종료된 xeno_ 접두사 포함)
401session_required아니오콘솔 엔드포인트를 유효한 콘솔 세션 쿠키 없이 불렀습니다
403insufficient_permission아니오역할이나 키 권한(run/read)이 이 요청을 허용하지 않습니다
404not_found아니오자원이 없거나 이 호출자에게 보이지 않습니다
429rate_limited가능이 키 또는 조직의 요청이 너무 많습니다, retryafters만큼 기다리세요
500internal_error가능예상하지 못한 오류입니다, 다시 시도하고 반복되면 request_id와 함께 알려 주세요

오류 봉투 모양과 전체 코드 표는 오류 코드에 있습니다

예시

curl "https://xenoci.com/api/runner/v1/cost?range=mtd&group_by=day,workspace" \
  -H "Authorization: Bearer $XENOCI_API_KEY"

다음 단계