계정 사용 API | EmpirioLabs AI Docs

계정 엔드포인트를 사용해 지출을 맞추거나, 제품 내 사용량을 보여주거나, 저장된 Playground 테스트를 내보내고 싶을 때 사용하세요.

사용과 균형

GET /v1/account/usage 현재 신용 잔액과 API 키에 연결된 계좌의 최근 사용 기록을 반환합니다.

$ curl "https://api.empiriolabs.ai/v1/account/usage?limit=25" \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

from, to, before, model, status, source로 필터링할 수 있습니다. 지원되는 source 가치는 api, playground, gpu_cloud, hosted_agents입니다.

각 사용 이벤트에는 다음이 포함됩니다:

필드	의미
`source`	`api`, `playground`, `gpu_cloud`, 혹은 `hosted_agents`
`model` 그리고 `endpoint`	무엇이라고 불렸는지. GPU Cloud 행에 대해 `model` GPU SKU 식별자입니다.
`tokens`	입력, 출력, 캐시, 총 토큰 수. GPU Cloud 런타임 이벤트와 같은 토큰 청구되지 않은 행은 토큰 수를 0으로 반환하고 런타임 세부 정보를 `metadata`에 입력합니다.
`cost.amount`	미화 단위로 차불 처리된 크레딧. 이것이 이 요청에 기소된 내용에 대한 유일한 진실의 출처입니다.
`status`, `status_code`, `error`	요청 결과
`output_urls`	생성된 미디어 URL 존재 시
`metadata.agent_type` / `metadata.agent_name` / `metadata.agent_instance_id`	호스트 에이전트 모델 호출을 통해 사용 흐름을 에이전트까지 추적할 수 있습니다.
`metadata.gpu_slug` / `metadata.gpu_display` / `metadata.seconds` / `metadata.price_hourly`	런타임 이벤트GPU Cloud 표시 이름, 런타임, 시간당 요금을 조정할 수 있도록 표시하세요.
`metadata.tool_usage`	모델이 공구별 추가 요금을 청구할 때의 `\{tool_name: count\}` 지도(예: `web_search`, `image_search`, `code_interpreter`, `web_extractor`). 적어도 한 가지 도구가 발사될 때만 나타납니다.
`metadata.list_cost` / `metadata.billed_cost` / `metadata.discount_amount`	계정 단위 가격 할인이 적용되었을 때만 표시됩니다. `cost.amount` 이미 할인 이후의 금액을 반영합니다; 이 필드들은 영수증 할인 내역을 기록합니다.

cost.amount 항상 최종 차감액입니다. metadata.list_cost / metadata.billed_cost 쌍은 정보 제공 기능입니다. 할인이 적용되면 cost.amount은 billed_cost가 됩니다. 할인이 적용되지 않으면 두 필드 모두 설정되지 않습니다; 그냥 읽어cost.amount.

GPU Cloud 이벤트는 런타임 보고에 source: "gpu_cloud" 플러스 metadata.seconds와 metadata.price_hourly를 사용하세요. 스키마 안정성을 위해 tokens 객체는 응답에 남아 있지만, GPU 런타임 행은 토큰 청구되지 않습니다.

도구 사용 예시

도구당 과비용을 청구하는 모델(Qwen, Perplexity, MiMo, Mistral)을 호출하고 해당 도구를 호출하면, 응답에는 정규화된 tool_usage 맵이 포함됩니다:

1 {
2   "id": "...",
3   "object": "usage_event",
4   "model": "qwen3-6-plus",
5   "cost": { "amount": 0.084, "currency": "USD" },
6   "tokens": { "input": 1250, "output": 480, "total": 1730 },
7   "metadata": {
8     "tool_usage": {
9       "web_search": 2,
10       "image_search": 1
11     }
12   }
13 }

cost.amount에는 이미 공구별 추가 요금이 포함되어 있습니다(여기: 2 × $0.026 web_search + 1 × $0.0208 image_search + token cost). tool_usage 도구를 사용해 어떤 도구가 기여했는지 세분화하세요.

저장된 놀이터 채팅

공개 API는 저장된 Playground 대화를 읽기 전용 리소스로 노출합니다.

저장된 놀이터 대화를 나열하세요:

$ curl "https://api.empiriolabs.ai/v1/playground/conversations" \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

ID별로 단일 대화를 검색하며, 전체 메시지 기록을 포함합니다:

$ curl "https://api.empiriolabs.ai/v1/playground/conversations/CONVERSATION_ID" \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Playground 채팅 저장 및 삭제는 여전히 대시보드에서 이루어집니다.