Service API Overview

Weave 기능에 프로그래밍 방식으로 액세스할 수 있도록 REST 엔드포인트를 제공하는 Weave Service API를 사용하세요.

​

기본 URL

W&B Multi-tenant Cloud 및 W&B Dedicated Cloud의 경우 다음 기본 URL을 사용하세요:

https://trace.wandb.ai

W&B Self-Managed 인스턴스에서는 다음을 사용하세요:

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

​

인증

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

curl -H "Authorization: Bearer YOUR_API_KEY" https://trace.wandb.ai/...

​

사용 가능한 엔드포인트

​

Call

• POST /call/end - Call 종료
• POST /call/read - Call 조회
• POST /call/start - Call 시작
• POST /call/update - Call 업데이트
• POST /call/upsert_batch - Call 시작 배치
• POST /calls/delete - Call 삭제
• POST /calls/query_stats - Call 쿼리 통계
• POST /calls/stats - Call 통계
• POST /calls/stream_query - Call 쿼리 스트림
• POST /calls/usage - Call 사용량
• POST /trace/usage - 트레이스 사용량

​

비용

• POST /cost/create - 비용 생성
• POST /cost/purge - 비용 삭제
• POST /cost/query - 비용 쿼리

​

피드백

• POST /feedback/batch/create - 피드백 일괄 생성
• POST /feedback/create - 피드백 생성
• POST /feedback/payload_schema - 피드백 페이로드 스키마
• POST /feedback/purge - 피드백 삭제
• POST /feedback/query - 피드백 쿼리
• POST /feedback/replace - 피드백 대체
• POST /feedback/stats - 피드백 통계

​

파일

• POST /file/content - 파일 내용
• POST /file/create - 파일 생성
• POST /files/query_stats - 파일 통계

​

객체

• GET /aliases - 별칭 목록
• POST /obj/create - 객체 생성
• POST /obj/delete - 객체 삭제
• POST /obj/read - 객체 조회
• POST /objs/query - 객체 쿼리
• PUT /objs/{object_id}/aliases - 객체 별칭 설정
• POST /objs/{object_id}/aliases/remove - 객체 별칭 제거
• PUT /objs/{object_id}/versions/{digest}/tags - 객체 태그 추가
• POST /objs/{object_id}/versions/{digest}/tags/remove - 객체 태그 제거
• GET /tags - 태그 목록

​

OpenTelemetry

• POST /otel/v1/traces - 트레이스 내보내기

​

Refs

• POST /refs/read_batch - Refs 일괄 조회

​

서비스

• GET /geolocate - 호출자 위치 조회
• GET /health - 루트 조회
• GET /server_info - 서버 정보
• POST /service/projects_info - Projects 정보
• GET /version - 버전 조회

​

Tables

• POST /table/create - Table 생성
• POST /table/create_from_digests - digest에서 Table 생성
• POST /table/query - Table 쿼리
• POST /table/query_stats - Table 쿼리 통계
• POST /table/query_stats_batch - Table 쿼리 통계 일괄 처리
• POST /table/update - Table 업데이트
• POST /table/query_stream - Table 쿼리 스트림

​

스레드

• POST /threads/stream_query - 스레드 쿼리 스트림

​

Inference

• GET /inference/analysis/artificialanalysis/models - Inference Analysis Artificialanalysis 모델
• GET /inference/nvidia/v2/hardware - NVIDIA 하드웨어
• GET /inference/router/openrouter/models - Inference Router OpenRouter 모델

​

어노테이션 큐

• POST /annotation_queues - 어노테이션 큐 생성
• POST /annotation_queues/query - 어노테이션 큐 쿼리 스트림
• POST /annotation_queues/stats - 어노테이션 큐 통계
• DELETE /annotation_queues/{queue_id} - 어노테이션 큐 삭제
• GET /annotation_queues/{queue_id} - 어노테이션 큐 조회
• PUT /annotation_queues/{queue_id} - 어노테이션 큐 업데이트
• POST /annotation_queues/{queue_id}/items - 어노테이션 큐에 Call 추가
• POST /annotation_queues/{queue_id}/items/query - 어노테이션 큐 항목 쿼리
• POST /annotation_queues/{queue_id}/items/{item_id}/progress - 어노테이션 큐 항목 진행 상태 업데이트

​

평가

• POST /evaluations/evaluate_model - 모델 평가
• POST /evaluations/status - 평가 상태
• GET /v2/{entity}/{project}/evaluations - 평가 목록
• POST /v2/{entity}/{project}/evaluations - 평가 생성
• DELETE /v2/{entity}/{project}/evaluations/{object_id} - 평가 삭제
• GET /v2/{entity}/{project}/evaluations/{object_id}/versions/{digest} - 평가 조회

​

점수

• POST /calls/score - Call 점수
• DELETE /v2/{entity}/{project}/scores - 점수 삭제
• GET /v2/{entity}/{project}/scores - 점수 목록
• POST /v2/{entity}/{project}/scores - 점수 생성
• GET /v2/{entity}/{project}/scores/{score_id} - 점수 조회

​

이미지

• POST /image/create - 이미지 생성

​

레지스트리

• POST /link_to_registry - 레지스트리에 연결

​

Ops

• GET /v2/{entity}/{project}/ops - Op 목록
• POST /v2/{entity}/{project}/ops - Op 생성
• DELETE /v2/{entity}/{project}/ops/{object_id} - Op 삭제
• GET /v2/{entity}/{project}/ops/{object_id}/versions/{digest} - Op 조회

​

Datasets

• GET /v2/{entity}/{project}/datasets - 데이터셋 목록
• POST /v2/{entity}/{project}/datasets - 데이터셋 생성
• DELETE /v2/{entity}/{project}/datasets/{object_id} - 데이터셋 삭제
• GET /v2/{entity}/{project}/datasets/{object_id}/versions/{digest} - 데이터셋 조회

​

Scorer

• GET /v2/{entity}/{project}/scorers - Scorer 목록
• POST /v2/{entity}/{project}/scorers - Scorer 생성
• DELETE /v2/{entity}/{project}/scorers/{object_id} - Scorer 삭제
• GET /v2/{entity}/{project}/scorers/{object_id}/versions/{digest} - Scorer 조회

​

모델

• GET /v2/{entity}/{project}/models - 모델 목록
• POST /v2/{entity}/{project}/models - 모델 생성
• DELETE /v2/{entity}/{project}/models/{object_id} - 모델 삭제
• GET /v2/{entity}/{project}/models/{object_id}/versions/{digest} - 모델 조회

​

평가 Runs

• DELETE /v2/{entity}/{project}/evaluation_runs - 평가 Run 삭제
• GET /v2/{entity}/{project}/evaluation_runs - 평가 Run 목록
• POST /v2/{entity}/{project}/evaluation_runs - 평가 Run 생성
• GET /v2/{entity}/{project}/evaluation_runs/{evaluation_run_id} - 평가 Run 조회
• POST /v2/{entity}/{project}/evaluation_runs/{evaluation_run_id}/finish - 평가 Run 완료

​

예측

• DELETE /v2/{entity}/{project}/predictions - 예측 삭제
• GET /v2/{entity}/{project}/predictions - 예측 목록
• POST /v2/{entity}/{project}/predictions - 예측 생성
• GET /v2/{entity}/{project}/predictions/{prediction_id} - 예측 조회
• POST /v2/{entity}/{project}/predictions/{prediction_id}/finish - 예측 완료

​

Eval 결과

• POST /v2/{entity}/{project}/eval_results/query - Eval 결과 쿼리