비용 대시보드 데이터 가져오기

얻다 /api/v1/projects/{id}/ 비용/ 대시보드
베어러 인증

오케스트레이션 엔진을 통해 집계된 비용 및 토큰 사용량 데이터를 반환합니다. 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다.

경로 매개변수

  • id 문자열 필수 사항

    프로젝트 ID

쿼리 매개변수

  • period 문자열

    기간(예: 7d, 30d, 90d)

  • Workspace_id 문자열

    작업 공간으로 필터링

응답

  • 406

    지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        유효성 검사 에 실패한 필드입니다.

        필드 속성 숨기기 필드 속성 표시 객체

        필드 및 해당 유효성 검사 실패.

        • description 문자열 필수 사항

          사람이 읽을 수 있는 유효성 검사 실패.

        • 필드 문자열 필수 사항

          잘못된 요청 필드 의 이름 또는 경로입니다.

    • 세부 정보 문자열 필수 사항

      사람이 읽을 수 있는 오류 세부 정보.

    • 오류 integer 필수 사항

      HTTP status code.

    • 오류 코드 문자열 필수 사항

      기계가 읽을 수 있는 오류 코드입니다.

    • 매개변수 array[string]

      오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.

    • 이유 문자열 필수 사항

      HTTP 상태 이유 구문입니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        유효성 검사 에 실패한 필드입니다.

        필드 속성 숨기기 필드 속성 표시 객체

        필드 및 해당 유효성 검사 실패.

        • description 문자열 필수 사항

          사람이 읽을 수 있는 유효성 검사 실패.

        • 필드 문자열 필수 사항

          잘못된 요청 필드 의 이름 또는 경로입니다.

    • 세부 정보 문자열 필수 사항

      사람이 읽을 수 있는 오류 세부 정보.

    • 오류 integer 필수 사항

      HTTP status code.

    • 오류 코드 문자열 필수 사항

      기계가 읽을 수 있는 오류 코드입니다.

    • 매개변수 array[string]

      오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.

    • 이유 문자열 필수 사항

      HTTP 상태 이유 구문입니다.
  • 200

    확인

    응답 속성 숨기기 응답 속성 표시 객체
    • by_model 배열[객체]
      by_model 속성 숨기기 by_model 속성 표시 객체
      • 호출 횟수 integer
      • 모델 문자열
      • 백분율 숫자
      • total_cost_usd 숫자
      • total_tokens integer
    • by_workspace 배열[객체]
      by_workspace 속성 숨기기 by_workspace 속성 표시 객체
      • 호출 횟수 integer
      • 백분율 숫자
      • total_cost_usd 숫자
      • total_tokens integer
      • Workspace_id 문자열
    • daily_trend 배열[객체]
      Hide daily_trend attributes daily_trend 속성 표시 객체
      • 호출 횟수 integer
      • 날짜 문자열
      • total_cost_usd 숫자
      • total_tokens integer
    • Success 부울
    • 요약 객체
      요약 속성 숨기기 요약 속성 표시 객체
      • total_completion_tokens integer
      • total_cost_usd 숫자
      • total_llm_calls integer
      • total_prompt_tokens integer
      • total_tokens integer
      • unaged_llm_calls integer
    응답 속성 숨기기 응답 속성 표시 객체
    • by_model 배열[객체]
      by_model 속성 숨기기 by_model 속성 표시 객체
      • 호출 횟수 integer
      • 모델 문자열
      • 백분율 숫자
      • total_cost_usd 숫자
      • total_tokens integer
    • by_workspace 배열[객체]
      by_workspace 속성 숨기기 by_workspace 속성 표시 객체
      • 호출 횟수 integer
      • 백분율 숫자
      • total_cost_usd 숫자
      • total_tokens integer
      • Workspace_id 문자열
    • daily_trend 배열[객체]
      Hide daily_trend attributes daily_trend 속성 표시 객체
      • 호출 횟수 integer
      • 날짜 문자열
      • total_cost_usd 숫자
      • total_tokens integer
    • Success 부울
    • 요약 객체
      요약 속성 숨기기 요약 속성 표시 객체
      • total_completion_tokens integer
      • total_cost_usd 숫자
      • total_llm_calls integer
      • total_prompt_tokens integer
      • total_tokens integer
      • unaged_llm_calls integer
  • 400

    잘못된 요청

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 401

    승인되지 않음

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 500

    내부 서버 오류

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 502

    잘못된 게이트웨이

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
GET /api/v1/projects/{id}/ 비용/ 대시보드 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/cost/dashboard' \
 --header "Authorization: $API_KEY"
응답 예시(406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
응답 예시(406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
응답 예시(200) 
{
  "by_model": [
    {
      "call_count": 42,
      "model": "string",
      "percentage": 42.0,
      "total_cost_usd": 42.0,
      "total_tokens": 42
    }
  ],
  "by_workspace": [
    {
      "call_count": 42,
      "percentage": 42.0,
      "total_cost_usd": 42.0,
      "total_tokens": 42,
      "workspace_id": "string"
    }
  ],
  "daily_trend": [
    {
      "call_count": 42,
      "date": "string",
      "total_cost_usd": 42.0,
      "total_tokens": 42
    }
  ],
  "success": true,
  "summary": {
    "total_completion_tokens": 42,
    "total_cost_usd": 42.0,
    "total_llm_calls": 42,
    "total_prompt_tokens": 42,
    "total_tokens": 42,
    "unpriced_llm_calls": 42
  }
}
응답 예시(200) 
{
  "by_model": [
    {
      "call_count": 42,
      "model": "string",
      "percentage": 42.0,
      "total_cost_usd": 42.0,
      "total_tokens": 42
    }
  ],
  "by_workspace": [
    {
      "call_count": 42,
      "percentage": 42.0,
      "total_cost_usd": 42.0,
      "total_tokens": 42,
      "workspace_id": "string"
    }
  ],
  "daily_trend": [
    {
      "call_count": 42,
      "date": "string",
      "total_cost_usd": 42.0,
      "total_tokens": 42
    }
  ],
  "success": true,
  "summary": {
    "total_completion_tokens": 42,
    "total_cost_usd": 42.0,
    "total_llm_calls": 42,
    "total_prompt_tokens": 42,
    "total_tokens": 42,
    "unpriced_llm_calls": 42
  }
}
응답 예시(400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(502) 
{
  "code": "string",
  "error": "string",
  "success": true
}