Videsk APIdocs
v1
Trang chủ

Chung

  • Xác thực
  • Giới hạn & lỗi
  • 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}

Các API khác

  • Nén ảnh
  • Chuyển đổi ảnh
Tất cả API/PDF Assistant API

PDF Assistant API

API phiên PDF: upload, chat SSE, trích dẫn trang. Yêu cầu API key để tích hợp.

v1https://api.videsk.vn/api

Cập nhật lần cuối: 9 tháng 6, 2026

1. Xác thực

Để xác thực cuộc gọi tới PDF Assistant API, hãy gửi API key của bạn trong header trên mỗi request:

Cần đồng ý điều khoản upload tài liệu trước khi upload PDF.

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: <api_key_cua_ban>
Keep your key secret!

2. Endpoints

Workflow phiên: tạo session → upload PDF → chat (SSE) → (tuỳ chọn) voice qua LiveKit.

POST/assistant/sessionsv1

Tạo phiên

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

Danh sách phiên

GET/assistant/sessions/{sessionId}v1

Chi tiết phiên + documents

POST/assistant/sessions/{sessionId}/documentsv1

Upload PDF

FieldBắt buộcMô tả
file*stringapplication/pdf, tối đa 15 MB
POST/assistant/sessions/{sessionId}/chatv1

Chat (SSE stream)

Content-Type: application/json. Phản hồi text/event-stream.

SSE events: status, token (stream), done (message + citations), error.
REQUEST EXAMPLE
json
{
  "content": "Tóm tắt hợp đồng trong 3 ý chính",
  "channel": "text"
}
GET/assistant/sessions/{sessionId}/messagesv1

Lịch sử tin nhắn

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

Xem PDF inline

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

Token voice (LiveKit)

DELETE/assistant/sessions/{sessionId}v1

Xóa phiên

3. Giới hạn & lỗi

Tài nguyênGiới hạn
Upload PDFstring
File / phiênstring
Trang / filestring
Chat trả về qua SSE. Lỗi trả JSON hoặc SSE error events.
Dùng thử trên web