API - Daven

Base URL 예:

https://edu.daven.ai/api/v1/mcp-proxy

OpenAPI: /edu/openapi.yaml

엔드포인트

Method	Path	Auth	설명
`GET`	`/health`	없음	헬스 체크
`GET`	`/api/account`	필요	계정 / 쿼터
`POST`	`/api/quote`	필요	생성 전 견적
`POST`	`/api/upload-url`	필요	업로드 URL 발급
`POST`	`/api/media/create`	필요	생성 잡 시작
`POST`	`/api/media/get`	필요	생성 상태 조회
`GET`	`/api/catalog`	필요	카탈로그 (`kind`, `query`)

요청 body 필드는 모델·도구마다 다릅니다. Daven Playground / @davenai/mcp tool 스키마와 같은 계열을 사용합니다.

응답 형식

Success

{
  "status": "success",
  "data": {},
  "code": "",
  "message": ""
}

Error

{
  "status": "error",
  "error": {
    "code": "AUTH_001",
    "message": "…",
    "detail": "optional"
  }
}

HTTP	의미
`200`	성공 (body의 `status`도 확인)
`401`	인증 실패

예시

curl -sS "$BASE/api/account" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Edu-Session: $TOKEN"

curl -sS -X POST "$BASE/api/quote" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Edu-Session: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -sS -X POST "$BASE/api/media/create" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Edu-Session: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -sS -X POST "$BASE/api/media/get" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Edu-Session: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"MEDIA_OR_JOB_ID"}'

curl -sS "$BASE/api/catalog?kind=voices" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Edu-Session: $TOKEN"