OneMux/Tài liệu/Tạo hội thoại

Tạo hội thoại

Endpoint tạo hội thoại tiêu chuẩn, dành cho các mô hình phổ biến như OpenAI, Anthropic và Google. Hỗ trợ hội thoại nhiều lượt, prompt hệ thống, đầu ra dạng luồng và tinh chỉnh tham số. Trang này giới thiệu định dạng yêu cầu, cấu trúc phản hồi, các tham số thường dùng và cách xử lý lỗi.

Thông tin API

Endpoint: POST /v1/chat/completions
Xác thực: Authorization: Bearer sk-xxx
Giao thức: Định dạng tương thích với OpenAI

Gọi API cơ bản

curl https://api.onemux.net/v1/chat/completions \
  -H "Authorization: Bearer $ONEMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [{"role": "user", "content": "Xin chào, OneMux"}]
  }'

Ví dụ phản hồi

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gpt-6.1-sol",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Xin chào! Tôi là trợ lý AI của OneMux..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

Hội thoại nhiều lượt

Mảng messages lưu lịch sử theo thứ tự thời gian:

response = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[
        {"role": "user", "content": "Tôi tên là Minh"},
        {"role": "assistant", "content": "Xin chào, Minh!"},
        {"role": "user", "content": "Tôi tên gì?"}
    ]
)
# AI sẽ trả lời: Bạn tên là Minh

Prompt hệ thống

Dùng vai trò system để thiết lập quy tắc hành vi cho AI:

messages = [
    {"role": "system", "content": "Bạn là kỹ sư Python chuyên nghiệp, hãy trả lời ngắn gọn và chuyên nghiệp"},
    {"role": "user", "content": "Làm thế nào để đọc tệp?"}
]

Các tham số thường dùng

Tham số	Mô tả	Giá trị đề xuất
temperature	Độ sáng tạo (0-2)	0.7 (mặc định), dùng 1.2 cho nội dung sáng tạo và 0.3 để tạo mã
max_tokens	Độ dài đầu ra tối đa	Thiết lập theo nhu cầu để tránh mô hình "dài dòng"
top_p	Lấy mẫu hạt nhân (0-1)	0.9 (mặc định)
stream	Đầu ra dạng luồng	true (khuyến nghị, trải nghiệm tốt hơn)