시작하기

이 GET API 는 인증된 계정 자신의 데이터만 읽습니다. 주 계정이 하위 계정 데이터 권한을 자동으로 얻지는 않으며 관리자도 자신만 조회합니다. 모델 API 키와 다른 시스템 액세스 토큰을 사용합니다.

시스템 액세스 토큰 받기

콘솔에 로그인한 후 설정의 시스템 액세스 토큰 영역에서 생성합니다. 다시 생성하면 이전 토큰이 무효화되므로 기존 연동도 갱신하세요. 이 조회는 읽기 전용이지만 토큰은 기존 API 의 권한을 유지하므로 토큰 자체가 읽기 전용인 것은 아닙니다.

Authorization 헤더는 하나만 보냅니다. cookie, URL 자격 증명, 모델 API 키, Agent 및 MCP 토큰은 대체할 수 없습니다. X-User-Id 는 필요하지 않습니다. 선택 항목인 X-Locale 은 en, zh, zh-TW, ja, ko, ru 를 지원하며, 유효한 값이 없으면 계정 설정과 언어 협상 규칙을 따릅니다.

curl --request GET \
  --url 'https://toapis.com/api/v1/account' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'

응답과 금액

성공 시 HTTP 200, code=0, message="" 을 반환합니다. 오류는 실제 HTTP 상태와 숫자 코드를 유지합니다. 번역되는 message 대신 HTTP 상태와 code 로 판단하세요. ID 와 금액은 문자열이며 시각은 시간대가 포함된 RFC 3339 입니다. 알 수 없거나 해당하지 않는 값은 계약에 따라 null 입니다.

잔액과 사용량의 USD 및 credits 는 같은 스냅샷에서 환산됩니다. 응답의 credits_per_usd 를 사용하고 기존 잔액 API 의 비율을 고정하지 마세요. 결제 금액은 원래 통화를 유지하며 credits 와 별개입니다.

응답에 Cache-Control: private, no-store 및 X-Request-Id 가 포함됩니다. 이 ID 는 현재 조회를 식별하며 사용량 내역의 원래 생성 요청 ID 와 다릅니다.

{"code": 0, "message": "", "data": {"items": [], "has_more": false, "next_cursor": null, "meta": {}}}

페이지 처리와 시간 범위

목록은 data.items, has_more, next_cursor, meta 를 반환합니다. 빈 목록은 [], 마지막 커서는 null 입니다. next_cursor 를 그대로 cursor 에 전달하고 필터를 유지하세요. 조건 변경 시 처음부터 조회하고 커서를 해석하지 마세요. 총 개수는 기본으로 계산하지 않습니다.

시간은 UTC 반개구간 [from,to) 로 비교합니다. 초 단위 저장 값의 경계는 올림합니다. from 과 to 는 함께 지정하며 사용량 조회에서는 항상 필수입니다. 작업 기본 범위는 최근 24 시간, 최대 31 일입니다. 충전과 청구서는 기본 31 일, 최대 366 일입니다. 기본 범위는 첫 페이지에서 고정되어 이후에도 시각을 생략할 수 있습니다. 알 수 없는 매개변수, 중복 스칼라 및 잘못된 이스케이프는 400 입니다.

호출 제한과 오류

사용자당 전체 분당 120 회입니다. 사용량 집계는 별도로 분당 6 회, 청구서 목록과 상세는 또 다른 분당 6 회 한도를 공유합니다. 429 에서는 Retry-After 에 따라 무작위 지연을 더해 대기합니다. Redis 장애 시 가벼운 조회는 노드별 IP 버킷과 사용자 각각 분당 30 회로 제한되고, 집계와 청구서는 503 을 반환합니다.

{
  "code": 10004,
  "message": "Invalid query parameters.",
  "data": {
    "param": "limit",
    "request_id": "request_example_query"
  }
}

데이터 범위

사용량은 변경 가능한 소비 로그 스냅샷입니다. 정산과 환불로 과거 기록이 바뀔 수 있어 완전한 순지출 원장이 아닙니다. 작업은 저장된 메타데이터와 확인된 결제만 제공하며 결과 반환, 상위 서비스 폴링, 정산 또는 환불을 수행하지 않습니다. 충전에는 수동 증정과 독립적인 오프라인 환불이 포함되지 않습니다. 청구서는 현재 검증된 Stripe Customer 만 포함합니다.

기존 API 와의 관계

토큰 잔액, 사용자 잔액, 토큰 생성은 기존 계약을 유지합니다. 이 그룹은 시스템 액세스 토큰과 code/message/data 응답을 사용합니다. 계정 작업 조회는 생성 결과 조회를 대체하지 않습니다.