Sume 개발자 대시보드: API 키·사용량·Job·결제·플레이그라운드
Sume 개발자 대시보드를 페이지별로 소개합니다. API 키 생성, Billing & subscription에서 크레딧 구매, Jobs·Usage 확인, 플레이그라운드에서 Avatar 시험을 다룹니다.
Sume 문서는 개발자 대시보드 페이지 다섯 개를 설명합니다. API 키 페이지에서는 워크스페이스 범위의 키를 만들고 관리하며, Billing & subscription에서는 요금제와 잔액을 확인하고 크레딧을 살 수 있습니다. Jobs는 최근 API Job을 상태·오류와 함께 보여 주고, Usage는 과금 대상 활동을 요약하며, Avatar 플레이그라운드에서는 코드를 쓰기 전에 Avatar 생성을 시험해 볼 수 있습니다.
세부 내용은 Sume 문서의 대시보드 섹션인 API 키, 결제와 크레딧, Jobs, Usage, Playground를 바탕으로 하며, 2026-09-26에 확인했습니다.
대시보드의 각 페이지는 어떤 일을 하나요?
문서는 대시보드를 API 키가 해석하는 같은 워크스페이스의 사람용 운영 표면이라고 설명합니다. Job, 잔액, 사용량은 공개 API로도 읽을 수 있습니다. 충전은 공개 API로 할 수 없는 대시보드 작업입니다.
| 페이지 | 하는 일 | 페이지에 나온 API 엔드포인트 |
|---|---|---|
| API 키 | 워크스페이스 범위의 Developer API 키 생성·관리 | — |
| Billing & subscription | 요금제 상태, 사용 가능한 잔액, 크레딧 구매 | GET /v1/balance, 충전 엔드포인트 없음 |
| Jobs | 최근 Developer API Job의 상태, 모드, 공개 결과 또는 오류 데이터, 가능한 경우 타임라인 정보 | GET /v1/jobs, GET /v1/jobs/:id(/status, /result, /events 포함), POST /v1/jobs/:id/cancel |
| Usage | 과금 대상 Developer API 활동을 사람이 보기 좋게 정리한 요약 | GET /v1/usage와 GET /v1/balance |
| Playground | 로그인한 워크스페이스 컨텍스트로 Avatar 생성 시험 | — |
API 키는 어떻게 만들고 보관하나요?
키는 API 키 페이지에서 만드세요. 키는 워크스페이스 범위이고, 대시보드는 키를 만들 때만 전체 비밀 값을 보여 주므로 곧바로 안전한 시크릿 매니저에 저장하세요. 헤더 형식, 스코프, 교체는 Sume API 키 동작 방식에서 다룹니다.
크레딧은 어떻게 추가하고, API로 충전할 수 있나요?
크레딧은 예전 문서에서 "Credits"라고 부르던 Billing & subscription 페이지에서 사세요. 워크스페이스에 결제가 설정돼 있으면 이 페이지에서 수동 크레딧 충전을 시작할 수 있고, 결제가 완료되면 사용량 원장에 충전 내역과 갱신된 잔액이 나타날 수 있습니다. 결제와 크레딧 문서는 공개 API가 잔액과 사용량 읽기만 제공하고 충전 엔드포인트는 없으므로, API 클라이언트가 충전을 대시보드 작업으로 다뤄야 한다고 안내합니다.
생성 비용은 API 요금에, 요금제는 요금제 페이지에 있습니다. 지갑 하나와 온디맨드 구매는 Sume 요금 체계에서 설명합니다.
Usage 페이지에는 무엇이 나오나요?
Usage는 과금 대상 Developer API 활동을 사람이 보기 좋게 정리한 요약입니다. 코드에서는 GET /v1/usage로 원장을, GET /v1/balance로 잔액을 읽으며, 둘 다 읽기 전용이고 키의 워크스페이스로 범위가 제한됩니다. 잔액은 USD 기준이며, 호환용 필드는 반올림한 센트 값을 크레딧으로 보여 줄 수 있습니다. 워크스페이스에 따라 원장 항목에는 예약, 확정, 환불, 충전, 그랜트가 포함될 수 있으며, Job ID와 request id가 각 행을 생성 작업과 이어 줍니다.
스레드 하나, 실행 하나, Job 하나의 합계를 내려면 GET /v1/usage에 thread_id, run_id, job_id를 붙이고, 행을 직접 더하지 말고 지갑에서 차감된 금액인 summary 필드 debited_usd_micros를 인용하세요. 이 요약은 Sume API 실행 한 번에 든 비용에서 자세히 다룹니다.
| 상태 | 의미 |
|---|---|
reserved | 프로바이더 실행 전에 추정 사용량을 예약함 |
captured | 성공적으로 완료된 뒤 과금 대상 사용량을 확정함 |
refunded | 확정 전에 실패하거나 취소되어 예약한 사용량을 되돌림 |
Jobs 페이지와 플레이그라운드는 어디에 쓰나요?
Jobs 페이지는 최근 Developer API Job을 사람이 직접 살펴보는 곳입니다. 코드에서는 위 표의 /v1/jobs 엔드포인트로 같은 Job을 읽습니다. 정확한 응답 형태는 라이브 OpenAPI 문서에 있습니다.
/playground의 플레이그라운드는 현재 Avatar 플레이그라운드로 연결됩니다. 로그인한 워크스페이스에서 사람이 직접 Avatar 생성을 시험해 보는 곳입니다. 페이로드를 서버 코드, CLI 명령어, 에이전트 워크플로로 옮기기 전에 검증하는 데 쓰고, 정확한 요청·응답 필드는 라이브 OpenAPI 스키마와 대조해 확인하세요.
출처
관련 글
작성자 Sume