API - Daven

Example base URL:

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

OpenAPI: /edu/openapi.yaml

Endpoints

Method	Path	Auth	Description
`GET`	`/health`	none	Health check
`GET`	`/api/account`	required	Account / quota
`POST`	`/api/quote`	required	Pre-generation quote
`POST`	`/api/upload-url`	required	Issue upload URL
`POST`	`/api/media/create`	required	Start generation job
`POST`	`/api/media/get`	required	Poll generation status
`GET`	`/api/catalog`	required	Catalog (`kind`, `query`)

Request body fields vary by model/tool. Use the same family as Daven Playground / @davenai/mcp tool schemas.

Response format

Success

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

Error

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

HTTP	Meaning
`200`	Success (also check body `status`)
`401`	Auth failed

Examples

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"