서비스 API 개요

​

기본 URL

https://trace.wandb.ai

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

​

인증

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 쿼리 Stats
• POST /calls/stats - Call Stats
• POST /calls/stream_query - Call 쿼리 스트림
• POST /calls/usage - Call 사용
• POST /trace/usage - 트레이스 사용
• POST /v2/{entity}/{project}/calls/complete - Call 완료

​

비용

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

​

피드백

• POST /feedback/aggregate - 피드백 집계
• POST /feedback/batch/create - 피드백 배치 생성
• POST /feedback/create - 피드백 생성
• POST /feedback/payload_schema - 피드백 페이로드 스키마
• POST /feedback/purge - 피드백 제거
• POST /feedback/query - 피드백 쿼리
• POST /feedback/replace - 피드백 교체
• POST /feedback/stats - 피드백 Stats

​

파일

• POST /file/content - 파일 콘텐츠
• POST /file/create - 파일 생성
• POST /files/query_stats - 파일 Stats

​

Objects

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

​

OpenTelemetry

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

​

Ref

• POST /refs/read_batch - Ref 조회 배치

​

서비스

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

​

Tables

• POST /table/create - table 생성
• POST /table/create_from_digests - digest로부터 table 생성
• POST /table/query - table 쿼리
• POST /table/query_stats - table 쿼리 Stats
• POST /table/query_stats_batch - table 쿼리 Stats 배치
• POST /table/update - table 업데이트

​

스레드

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

​

Inference

• GET /inference/analysis/artificialanalysis/models - Inference Analysis Artificialanalysis 모델
• GET /inference/catalog/models - Inference Catalog 모델
• GET /inference/modelsdev/models - Inference Modelsdev 모델
• GET /inference/nvidia/v2/hardware - Nvidia Hardware
• GET /inference/router/openrouter/models - Inference Router Openrouter 모델

​

에이전트

• POST /agents/agent-versions/query - GenAI 에이전트 버전 쿼리
• POST /agents/conversations/chat - GenAI 대화 채팅
• POST /agents/conversations/spans - GenAI 대화 spans
• POST /agents/otel/v1/traces - GenAI 트레이스 내보내기
• POST /agents/query - GenAI 에이전트 쿼리
• POST /agents/search - GenAI 검색
• POST /agents/spans/custom-attrs/schema - GenAI 맞춤형 Attrs 스키마
• POST /agents/spans/query - GenAI spans 쿼리
• POST /agents/spans/stats - GenAI spans Stats
• POST /agents/traces/chat - GenAI 트레이스 채팅

​

어노테이션 큐

• POST /annotation_queues - 어노테이션 큐 생성
• POST /annotation_queues/query - 어노테이션 큐 쿼리 스트림
• POST /annotation_queues/stats - 어노테이션 큐 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 - 어노테이션 큐 항목 진행 상황 업데이트

​

맞춤형 런타임

• PUT /v2/{entity}/{project}/runtimes/{runtime_name} - 맞춤형 런타임 적용

​

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} - 데이터셋 조회

​

Eval Results

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

​

평가 run

• 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 종료

​

평가

• POST /evaluations/evaluate_model - 모델 평가
• POST /evaluations/rescore - 평가 재점수
• 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 /image/create - 이미지 생성

​

모델

• 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} - 모델 조회

​

Op

• 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 조회

​

예측

• 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 - 예측 종료

​

레지스트리

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

​

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 조회

​

점수

• 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} - 점수 조회