Tổng quan

Đặc điểm kỹ thuật

Tính năng nổi bật

API Endpoints

Base URL

Danh sách Endpoints

{
  "message": "string (required)",
  "system": "Bạn là trợ lý AI hữu ích, trả lời bằng tiếng Việt.",
  "temperature": 0.7,
  "max_tokens": 800
}

{
  "response": "string",
  "model": "qwen2.5-7b",
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 150,
    "total_tokens": 170
  }
}

{
  "model": "qwen2.5-7b",
  "messages": [
    {"role": "system", "content": "..."},
    {"role": "user", "content": "..."}
  ],
  "temperature": 0.7,
  "max_tokens": 800,
  "top_p": 0.95,
  "stream": false
}

{
  "task": "string (required) — mô tả nhiệm vụ",
  "context": "string (optional) — dữ liệu/ngữ cảnh nền",
  "output_format": "string (optional) — e.g. 'JSON', 'bullet list'",
  "temperature": 0.3,
  "max_tokens": 1200
}

{
  "task": "string",
  "result": "string",
  "model": "qwen2.5-7b",
  "usage": { ... }
}

Xác thực

Cách dùng

Authorization: Bearer YOUR_API_TOKEN

Ví dụ sử dụng

1. Simple Chat (cURL)

curl -X POST https://pnt.badt.vn/qwen/chat \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Triệu chứng của bệnh viêm phổi là gì?",
    "max_tokens": 300,
    "temperature": 0.7
  }'

Response

{
  "response": "Triệu chứng của bệnh viêm phổi thường bao gồm:\n\n1. Ho có đờm (có thể có máu)\n2. Sốt cao...",
  "model": "qwen2.5-7b",
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 112,
    "total_tokens": 130
  }
}

2. Chat với System Prompt (Python)

import requests
import os

url = "https://pnt.badt.vn/qwen/chat"
headers = {
    "Authorization": f"Bearer {os.getenv('QWEN_API_TOKEN')}",
    "Content-Type": "application/json"
}
data = {
    "message": "Bệnh nhân 45 tuổi, ho kéo dài 3 tuần. Hướng chẩn đoán?",
    "system": "Bạn là bác sĩ nội khoa. Trả lời ngắn gọn, chuyên nghiệp.",
    "max_tokens": 400,
    "temperature": 0.7
}

response = requests.post(url, json=data, headers=headers)
result = response.json()
print(result["response"])

3. Health Check

curl https://pnt.badt.vn/qwen/health \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

{
  "status": "healthy",
  "service": "qwen_service",
  "vllm_server": "healthy",
  "model": "Qwen/Qwen2.5-7B-Instruct-AWQ",
  "timestamp": "2026-04-12T09:15:00.000000"
}

Agent Endpoint /agent

Ví dụ — Tóm tắt hồ sơ bệnh án

curl -X POST https://pnt.badt.vn/qwen/agent \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Tóm tắt chẩn đoán chính và hướng điều trị",
    "context": "BN nam 62 tuổi, nhập viện ngày 10/04/2026 vì khó thở tăng dần 3 ngày. Tiền sử THA, ĐTĐ type 2. ECG: ST chênh lên V2-V4. Troponin T: 2.8 ng/mL. Siêu âm tim: EF 35%. Xử trí...",
    "output_format": "bullet list",
    "temperature": 0.3,
    "max_tokens": 500
  }'

Ví dụ — Trích xuất dữ liệu JSON

import requests, os

url = "https://pnt.badt.vn/qwen/agent"
headers = {
    "Authorization": f"Bearer {os.getenv('QWEN_API_TOKEN')}",
    "Content-Type": "application/json"
}
data = {
    "task": "Trích xuất thông tin bệnh nhân thành JSON",
    "context": "Nguyễn Văn An, 55 tuổi, nam, nhập viện 10/4/2026. Chẩn đoán: NMCT cấp ST chênh lên. Điều trị: Aspirin 300mg, Heparin IV.",
    "output_format": "JSON",
    "temperature": 0.1,
    "max_tokens": 300
}

response = requests.post(url, json=data, headers=headers)
print(response.json()["result"])

OpenAI Compatible API

Qwen service hỗ trợ đầy đủ OpenAI-compatible API — dùng trực tiếp với OpenAI Python/JS SDK:

Python với OpenAI SDK

from openai import OpenAI
import os

client = OpenAI(
    api_key="not-needed",
    base_url="https://pnt.badt.vn/qwen/v1",
    default_headers={
        "Authorization": f"Bearer {os.getenv('QWEN_API_TOKEN')}"
    }
)

response = client.chat.completions.create(
    model="qwen2.5-7b",
    messages=[
        {"role": "system", "content": "Bạn là bác sĩ AI chuyên y học nội khoa."},
        {"role": "user", "content": "Triệu chứng suy tim sung huyết?"}
    ],
    temperature=0.7,
    max_tokens=400
)

print(response.choices[0].message.content)

JavaScript với OpenAI SDK

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: 'not-needed',
    baseURL: 'https://pnt.badt.vn/qwen/v1',
    defaultHeaders: {
        'Authorization': `Bearer ${process.env.QWEN_API_TOKEN}`
    }
});

const response = await client.chat.completions.create({
    model: 'qwen2.5-7b',
    messages: [
        { role: 'system', content: 'Bạn là trợ lý y tế AI.' },
        { role: 'user', content: 'Xin chào!' }
    ],
    max_tokens: 200
});

console.log(response.choices[0].message.content);

Rate Limits

Error Codes

Tài liệu bổ sung