Videsk APIdocs
v1
Home

General

  • Authentication
  • Limits & errors
  • POST/assistant/sessions
  • GET/assistant/sessions
  • GET/assistant/sessions/{sessionId}
  • POST/assistant/sessions/{sessionId}/documents
  • POST/assistant/sessions/{sessionId}/chat
  • GET/assistant/sessions/{sessionId}/messages
  • GET/assistant/sessions/{sessionId}/documents/{documentId}/view
  • POST/assistant/sessions/{sessionId}/livekit-token
  • DELETE/assistant/sessions/{sessionId}

Other APIs

  • Image Compress
  • Image Convert
All APIs/PDF Assistant API

PDF Assistant API

PDF session API: upload, SSE chat, citations. Requires an API key for access.

v1https://api.videsk.vn/api

Last updated: June 9, 2026

1. Authentication

To authenticate calls to the PDF Assistant API, send your API key in the header on every request:

Document upload consent is required before uploading PDFs.

1

X-Videsk-Access-Token

Send your registered API key as a header on every integration request.

2

Keep it safe

Never expose your API key in browser-side javascript. Always proxy requests.

http
X-Videsk-Access-Token: <your_api_key>
Keep your key secret!

2. Endpoints

Session workflow: create session → upload PDF → chat (SSE) → optional voice via LiveKit.

POST/assistant/sessionsv1

Create session

RESPONSE EXAMPLE
200 OK
json
{
  "id": "uuid",
  "status": "active",
  "createdAt": "2026-06-09T08:00:00.000Z"
}
GET/assistant/sessionsv1

List sessions

GET/assistant/sessions/{sessionId}v1

Session detail + documents

POST/assistant/sessions/{sessionId}/documentsv1

Upload PDF

FieldRequiredDescription
file*stringapplication/pdf, max 15 MB
POST/assistant/sessions/{sessionId}/chatv1

Chat (SSE stream)

Content-Type: application/json. Response: text/event-stream.

SSE events: status, token (stream), done (message + citations), error.
REQUEST EXAMPLE
json
{
  "content": "Summarize this contract in 3 bullet points",
  "channel": "text"
}
GET/assistant/sessions/{sessionId}/messagesv1

Message history

GET/assistant/sessions/{sessionId}/documents/{documentId}/viewv1

View PDF inline

POST/assistant/sessions/{sessionId}/livekit-tokenv1

Voice token (LiveKit)

DELETE/assistant/sessions/{sessionId}v1

Delete session

3. Limits & errors

ResourceLimit
PDF uploadstring
Files per sessionstring
Pages per filestring
Chat responses stream via SSE. Errors return JSON or SSE error events.
Try web tool