> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 서비스 API 개요

> Weave 서비스 API를 사용하세요. 이 API는 Weave 기능에 대한 프로그래밍 방식의 액세스를 제공하는 REST 엔드포인트를 제공합니다.

<h2 id="base-url">
  기본 URL
</h2>

[W\&B Multi-tenant Cloud](/ko/products/wandb/platform/hosting/hosting-options/multi_tenant_cloud) 및 [W\&B Dedicated Cloud](/ko/products/wandb/platform/hosting/hosting-options/dedicated-cloud)의 경우 다음 기본 URL을 사용하세요:

```
https://trace.wandb.ai
```

[W\&B Self-Managed 인스턴스](/ko/products/wandb/weave/guides/platform/weave-self-managed)의 경우 다음을 사용하세요:

```
https://<your-subdomain>.wandb.io/traces
```

<h2 id="authentication">
  인증
</h2>

요청 헤더에 W\&B API 키를 포함하세요:

```bash theme={"system"}
curl -H "Authorization: Bearer YOUR_API_KEY" https://trace.wandb.ai/...
```

<h2 id="available-endpoints">
  사용 가능한 엔드포인트
</h2>

<h3 id="calls">
  Call
</h3>

* **[POST `/call/end`](/ko/products/wandb/weave/reference/service-api/calls/call-end)** - Call 종료
* **[POST `/call/read`](/ko/products/wandb/weave/reference/service-api/calls/call-read)** - Call 조회
* **[POST `/call/start`](/ko/products/wandb/weave/reference/service-api/calls/call-start)** - Call 시작
* **[POST `/call/update`](/ko/products/wandb/weave/reference/service-api/calls/call-update)** - Call 업데이트
* **[POST `/call/upsert_batch`](/ko/products/wandb/weave/reference/service-api/calls/call-start-batch)** - Call 시작 배치
* **[POST `/calls/delete`](/ko/products/wandb/weave/reference/service-api/calls/calls-delete)** - Call 삭제
* **[POST `/calls/query_stats`](/ko/products/wandb/weave/reference/service-api/calls/calls-query-stats)** - Call 쿼리 Stats
* **[POST `/calls/stats`](/ko/products/wandb/weave/reference/service-api/calls/call-stats)** - Call Stats
* **[POST `/calls/stream_query`](/ko/products/wandb/weave/reference/service-api/calls/calls-query-stream)** - Call 쿼리 스트림
* **[POST `/calls/usage`](/ko/products/wandb/weave/reference/service-api/calls/calls-usage)** - Call 사용
* **[POST `/trace/usage`](/ko/products/wandb/weave/reference/service-api/calls/trace-usage)** - 트레이스 사용
* **[POST `/v2/{entity}/{project}/calls/complete`](/ko/products/wandb/weave/reference/service-api/calls/calls-complete)** - Call 완료

<h3 id="costs">
  비용
</h3>

* **[POST `/cost/create`](/ko/products/wandb/weave/reference/service-api/costs/cost-create)** - 비용 생성
* **[POST `/cost/purge`](/ko/products/wandb/weave/reference/service-api/costs/cost-purge)** - 비용 제거
* **[POST `/cost/query`](/ko/products/wandb/weave/reference/service-api/costs/cost-query)** - 비용 쿼리

<h3 id="feedback">
  피드백
</h3>

* **[POST `/feedback/aggregate`](/ko/products/wandb/weave/reference/service-api/feedback/feedback-aggregate)** - 피드백 집계
* **[POST `/feedback/batch/create`](/ko/products/wandb/weave/reference/service-api/feedback/feedback-create-batch)** - 피드백 배치 생성
* **[POST `/feedback/create`](/ko/products/wandb/weave/reference/service-api/feedback/feedback-create)** - 피드백 생성
* **[POST `/feedback/payload_schema`](/ko/products/wandb/weave/reference/service-api/feedback/feedback-payload-schema)** - 피드백 페이로드 스키마
* **[POST `/feedback/purge`](/ko/products/wandb/weave/reference/service-api/feedback/feedback-purge)** - 피드백 제거
* **[POST `/feedback/query`](/ko/products/wandb/weave/reference/service-api/feedback/feedback-query)** - 피드백 쿼리
* **[POST `/feedback/replace`](/ko/products/wandb/weave/reference/service-api/feedback/feedback-replace)** - 피드백 교체
* **[POST `/feedback/stats`](/ko/products/wandb/weave/reference/service-api/feedback/feedback-stats)** - 피드백 Stats

<h3 id="files">
  파일
</h3>

* **[POST `/file/content`](/ko/products/wandb/weave/reference/service-api/files/file-content)** - 파일 콘텐츠
* **[POST `/file/create`](/ko/products/wandb/weave/reference/service-api/files/file-create)** - 파일 생성
* **[POST `/files/query_stats`](/ko/products/wandb/weave/reference/service-api/files/files-stats)** - 파일 Stats

<h3 id="objects">
  Objects
</h3>

* **[GET `/aliases`](/ko/products/wandb/weave/reference/service-api/objects/aliases-list)** - 별칭 목록
* **[POST `/obj/create`](/ko/products/wandb/weave/reference/service-api/objects/obj-create)** - Obj 생성
* **[POST `/obj/delete`](/ko/products/wandb/weave/reference/service-api/objects/obj-delete)** - Obj 삭제
* **[POST `/obj/read`](/ko/products/wandb/weave/reference/service-api/objects/obj-read)** - Obj 조회
* **[POST `/objs/query`](/ko/products/wandb/weave/reference/service-api/objects/objs-query)** - Objs 쿼리
* **[PUT `/objs/{object_id}/aliases`](/ko/products/wandb/weave/reference/service-api/objects/obj-set-aliases)** - Obj 별칭 설정
* **[POST `/objs/{object_id}/aliases/remove`](/ko/products/wandb/weave/reference/service-api/objects/obj-remove-aliases)** - Obj 별칭 제거
* **[PUT `/objs/{object_id}/versions/{digest}/tags`](/ko/products/wandb/weave/reference/service-api/objects/obj-add-tags)** - Obj 태그 추가
* **[POST `/objs/{object_id}/versions/{digest}/tags/remove`](/ko/products/wandb/weave/reference/service-api/objects/obj-remove-tags)** - Obj 태그 제거
* **[GET `/tags`](/ko/products/wandb/weave/reference/service-api/objects/tags-list)** - 태그 목록

<h3 id="opentelemetry">
  OpenTelemetry
</h3>

* **[POST `/otel/v1/traces`](/ko/products/wandb/weave/reference/service-api/opentelemetry/export-trace)** - 트레이스 내보내기

<h3 id="refs">
  Ref
</h3>

* **[POST `/refs/read_batch`](/ko/products/wandb/weave/reference/service-api/refs/refs-read-batch)** - Ref 조회 배치

<h3 id="service">
  서비스
</h3>

* **[GET `/geolocate`](/ko/products/wandb/weave/reference/service-api/service/get-caller-location)** - 호출자 위치 조회
* **[GET `/health`](/ko/products/wandb/weave/reference/service-api/service/read-root)** - 루트 조회
* **[GET `/server_info`](/ko/products/wandb/weave/reference/service-api/service/server-info)** - 서버 정보
* **[POST `/service/projects_info`](/ko/products/wandb/weave/reference/service-api/service/projects-info)** - 프로젝트 정보
* **[GET `/version`](/ko/products/wandb/weave/reference/service-api/service/read-version)** - 버전 조회

<h3 id="tables">
  Tables
</h3>

* **[POST `/table/create`](/ko/products/wandb/weave/reference/service-api/tables/table-create)** - table 생성
* **[POST `/table/create_from_digests`](/ko/products/wandb/weave/reference/service-api/tables/table-create-from-digests)** - digest로부터 table 생성
* **[POST `/table/query`](/ko/products/wandb/weave/reference/service-api/tables/table-query)** - table 쿼리
* **[POST `/table/query_stats`](/ko/products/wandb/weave/reference/service-api/tables/table-query-stats)** - table 쿼리 Stats
* **[POST `/table/query_stats_batch`](/ko/products/wandb/weave/reference/service-api/tables/table-query-stats-batch)** - table 쿼리 Stats 배치
* **[POST `/table/update`](/ko/products/wandb/weave/reference/service-api/tables/table-update)** - table 업데이트

<h3 id="threads">
  스레드
</h3>

* **[POST `/threads/stream_query`](/ko/products/wandb/weave/reference/service-api/threads/threads-query-stream)** - 스레드 쿼리 스트림

<h3 id="inference">
  Inference
</h3>

* **[GET `/inference/analysis/artificialanalysis/models`](/ko/products/wandb/weave/reference/service-api/inference/inference-analysis-artificialanalysis-models)** - Inference Analysis Artificialanalysis 모델
* **[GET `/inference/catalog/models`](/ko/products/wandb/weave/reference/service-api/inference/inference-catalog-models)** - Inference Catalog 모델
* **[GET `/inference/modelsdev/models`](/ko/products/wandb/weave/reference/service-api/inference/inference-modelsdev-models)** - Inference Modelsdev 모델
* **[GET `/inference/nvidia/v2/hardware`](/ko/products/wandb/weave/reference/service-api/inference/nvidia-hardware)** - Nvidia Hardware
* **[GET `/inference/router/openrouter/models`](/ko/products/wandb/weave/reference/service-api/inference/inference-router-openrouter-models)** - Inference Router Openrouter 모델

<h3 id="agents">
  에이전트
</h3>

* **[POST `/agents/agent-versions/query`](/ko/products/wandb/weave/reference/service-api/agents/genai-agent-versions-query)** - GenAI 에이전트 버전 쿼리
* **[POST `/agents/conversations/chat`](/ko/products/wandb/weave/reference/service-api/agents/genai-conversation-chat)** - GenAI 대화 채팅
* **[POST `/agents/conversations/spans`](/ko/products/wandb/weave/reference/service-api/agents/genai-conversation-spans)** - GenAI 대화 spans
* **[POST `/agents/otel/v1/traces`](/ko/products/wandb/weave/reference/service-api/agents/export-genai-trace)** - GenAI 트레이스 내보내기
* **[POST `/agents/query`](/ko/products/wandb/weave/reference/service-api/agents/genai-agents-query)** - GenAI 에이전트 쿼리
* **[POST `/agents/search`](/ko/products/wandb/weave/reference/service-api/agents/genai-search)** - GenAI 검색
* **[POST `/agents/spans/custom-attrs/schema`](/ko/products/wandb/weave/reference/service-api/agents/genai-custom-attrs-schema)** - GenAI 맞춤형 Attrs 스키마
* **[POST `/agents/spans/query`](/ko/products/wandb/weave/reference/service-api/agents/genai-spans-query)** - GenAI spans 쿼리
* **[POST `/agents/spans/stats`](/ko/products/wandb/weave/reference/service-api/agents/genai-spans-stats)** - GenAI spans Stats
* **[POST `/agents/traces/chat`](/ko/products/wandb/weave/reference/service-api/agents/genai-traces-chat)** - GenAI 트레이스 채팅

<h3 id="annotation-queues">
  어노테이션 큐
</h3>

* **[POST `/annotation_queues`](/ko/products/wandb/weave/reference/service-api/annotation-queues/annotation-queue-create)** - 어노테이션 큐 생성
* **[POST `/annotation_queues/query`](/ko/products/wandb/weave/reference/service-api/annotation-queues/annotation-queues-query-stream)** - 어노테이션 큐 쿼리 스트림
* **[POST `/annotation_queues/stats`](/ko/products/wandb/weave/reference/service-api/annotation-queues/annotation-queues-stats)** - 어노테이션 큐 Stats
* **[DELETE `/annotation_queues/{queue_id}`](/ko/products/wandb/weave/reference/service-api/annotation-queues/annotation-queue-delete)** - 어노테이션 큐 삭제
* **[GET `/annotation_queues/{queue_id}`](/ko/products/wandb/weave/reference/service-api/annotation-queues/annotation-queue-read)** - 어노테이션 큐 조회
* **[PUT `/annotation_queues/{queue_id}`](/ko/products/wandb/weave/reference/service-api/annotation-queues/annotation-queue-update)** - 어노테이션 큐 업데이트
* **[POST `/annotation_queues/{queue_id}/items`](/ko/products/wandb/weave/reference/service-api/annotation-queues/annotation-queue-add-calls)** - 어노테이션 큐 Call 추가
* **[POST `/annotation_queues/{queue_id}/items/query`](/ko/products/wandb/weave/reference/service-api/annotation-queues/annotation-queue-items-query)** - 어노테이션 큐 항목 쿼리
* **[POST `/annotation_queues/{queue_id}/items/{item_id}/progress`](/ko/products/wandb/weave/reference/service-api/annotation-queues/annotation-queue-item-progress-update)** - 어노테이션 큐 항목 진행 상황 업데이트

<h3 id="custom-runtimes">
  맞춤형 런타임
</h3>

* **[PUT `/v2/{entity}/{project}/runtimes/{runtime_name}`](/ko/products/wandb/weave/reference/service-api/custom-runtimes/custom-runtime-apply)** - 맞춤형 런타임 적용

<h3 id="datasets">
  Datasets
</h3>

* **[GET `/v2/{entity}/{project}/datasets`](/ko/products/wandb/weave/reference/service-api/datasets/dataset-list)** - 데이터셋 목록
* **[POST `/v2/{entity}/{project}/datasets`](/ko/products/wandb/weave/reference/service-api/datasets/dataset-create)** - 데이터셋 생성
* **[DELETE `/v2/{entity}/{project}/datasets/{object_id}`](/ko/products/wandb/weave/reference/service-api/datasets/dataset-delete)** - 데이터셋 삭제
* **[GET `/v2/{entity}/{project}/datasets/{object_id}/versions/{digest}`](/ko/products/wandb/weave/reference/service-api/datasets/dataset-read)** - 데이터셋 조회

<h3 id="eval-results">
  Eval Results
</h3>

* **[POST `/v2/{entity}/{project}/eval_results/query`](/ko/products/wandb/weave/reference/service-api/eval-results/eval-results-query)** - Eval Results 쿼리

<h3 id="evaluation-runs">
  평가 run
</h3>

* **[DELETE `/v2/{entity}/{project}/evaluation_runs`](/ko/products/wandb/weave/reference/service-api/evaluation-runs/evaluation-run-delete)** - 평가 run 삭제
* **[GET `/v2/{entity}/{project}/evaluation_runs`](/ko/products/wandb/weave/reference/service-api/evaluation-runs/evaluation-run-list)** - 평가 run 목록
* **[POST `/v2/{entity}/{project}/evaluation_runs`](/ko/products/wandb/weave/reference/service-api/evaluation-runs/evaluation-run-create)** - 평가 run 생성
* **[GET `/v2/{entity}/{project}/evaluation_runs/{evaluation_run_id}`](/ko/products/wandb/weave/reference/service-api/evaluation-runs/evaluation-run-read)** - 평가 run 조회
* **[POST `/v2/{entity}/{project}/evaluation_runs/{evaluation_run_id}/finish`](/ko/products/wandb/weave/reference/service-api/evaluation-runs/evaluation-run-finish)** - 평가 run 종료

<h3 id="evaluations">
  평가
</h3>

* **[POST `/evaluations/evaluate_model`](/ko/products/wandb/weave/reference/service-api/evaluations/evaluate-model)** - 모델 평가
* **[POST `/evaluations/rescore`](/ko/products/wandb/weave/reference/service-api/evaluations/rescore-evaluation)** - 평가 재점수
* **[POST `/evaluations/status`](/ko/products/wandb/weave/reference/service-api/evaluations/evaluation-status)** - 평가 상태
* **[GET `/v2/{entity}/{project}/evaluations`](/ko/products/wandb/weave/reference/service-api/evaluations/evaluation-list)** - 평가 목록
* **[POST `/v2/{entity}/{project}/evaluations`](/ko/products/wandb/weave/reference/service-api/evaluations/evaluation-create)** - 평가 생성
* **[DELETE `/v2/{entity}/{project}/evaluations/{object_id}`](/ko/products/wandb/weave/reference/service-api/evaluations/evaluation-delete)** - 평가 삭제
* **[GET `/v2/{entity}/{project}/evaluations/{object_id}/versions/{digest}`](/ko/products/wandb/weave/reference/service-api/evaluations/evaluation-read)** - 평가 조회

<h3 id="images">
  이미지
</h3>

* **[POST `/image/create`](/ko/products/wandb/weave/reference/service-api/images/image-create)** - 이미지 생성

<h3 id="models">
  모델
</h3>

* **[GET `/v2/{entity}/{project}/models`](/ko/products/wandb/weave/reference/service-api/models/model-list)** - 모델 목록
* **[POST `/v2/{entity}/{project}/models`](/ko/products/wandb/weave/reference/service-api/models/model-create)** - 모델 생성
* **[DELETE `/v2/{entity}/{project}/models/{object_id}`](/ko/products/wandb/weave/reference/service-api/models/model-delete)** - 모델 삭제
* **[GET `/v2/{entity}/{project}/models/{object_id}/versions/{digest}`](/ko/products/wandb/weave/reference/service-api/models/model-read)** - 모델 조회

<h3 id="ops">
  Op
</h3>

* **[GET `/v2/{entity}/{project}/ops`](/ko/products/wandb/weave/reference/service-api/ops/op-list)** - Op 목록
* **[POST `/v2/{entity}/{project}/ops`](/ko/products/wandb/weave/reference/service-api/ops/op-create)** - Op 생성
* **[DELETE `/v2/{entity}/{project}/ops/{object_id}`](/ko/products/wandb/weave/reference/service-api/ops/op-delete)** - Op 삭제
* **[GET `/v2/{entity}/{project}/ops/{object_id}/versions/{digest}`](/ko/products/wandb/weave/reference/service-api/ops/op-read)** - Op 조회

<h3 id="predictions">
  예측
</h3>

* **[DELETE `/v2/{entity}/{project}/predictions`](/ko/products/wandb/weave/reference/service-api/predictions/prediction-delete)** - 예측 삭제
* **[GET `/v2/{entity}/{project}/predictions`](/ko/products/wandb/weave/reference/service-api/predictions/prediction-list)** - 예측 목록
* **[POST `/v2/{entity}/{project}/predictions`](/ko/products/wandb/weave/reference/service-api/predictions/prediction-create)** - 예측 생성
* **[GET `/v2/{entity}/{project}/predictions/{prediction_id}`](/ko/products/wandb/weave/reference/service-api/predictions/prediction-read)** - 예측 조회
* **[POST `/v2/{entity}/{project}/predictions/{prediction_id}/finish`](/ko/products/wandb/weave/reference/service-api/predictions/prediction-finish)** - 예측 종료

<h3 id="registry">
  레지스트리
</h3>

* **[POST `/link_to_registry`](/ko/products/wandb/weave/reference/service-api/registry/link-to-registry)** - 레지스트리에 연결

<h3 id="scorers">
  Scorer
</h3>

* **[GET `/v2/{entity}/{project}/scorers`](/ko/products/wandb/weave/reference/service-api/scorers/scorer-list)** - Scorer 목록
* **[POST `/v2/{entity}/{project}/scorers`](/ko/products/wandb/weave/reference/service-api/scorers/scorer-create)** - Scorer 생성
* **[DELETE `/v2/{entity}/{project}/scorers/{object_id}`](/ko/products/wandb/weave/reference/service-api/scorers/scorer-delete)** - Scorer 삭제
* **[GET `/v2/{entity}/{project}/scorers/{object_id}/versions/{digest}`](/ko/products/wandb/weave/reference/service-api/scorers/scorer-read)** - Scorer 조회

<h3 id="scores">
  점수
</h3>

* **[POST `/calls/score`](/ko/products/wandb/weave/reference/service-api/scores/calls-score)** - Call 점수
* **[DELETE `/v2/{entity}/{project}/scores`](/ko/products/wandb/weave/reference/service-api/scores/score-delete)** - 점수 삭제
* **[GET `/v2/{entity}/{project}/scores`](/ko/products/wandb/weave/reference/service-api/scores/score-list)** - 점수 목록
* **[POST `/v2/{entity}/{project}/scores`](/ko/products/wandb/weave/reference/service-api/scores/score-create)** - 점수 생성
* **[GET `/v2/{entity}/{project}/scores/{score_id}`](/ko/products/wandb/weave/reference/service-api/scores/score-read)** - 점수 조회