openclaw/translation/vietnamese/docs/gateway/openai-http-api.vi.md

1.7 KiB

summary read_when
Cổng HTTP /v1/chat/completions tương thích với OpenAI từ Gateway
Bạn muốn dùng các ứng dụng hoặc công cụ vốn được thiết kế cho OpenAI để kết nối với Moltbot

API tương thích OpenAI (HTTP)

Gateway của Moltbot cung cấp một cổng (endpoint) nhỏ tương thích với chuẩn OpenAI Chat Completions. Tính năng này bị tắt theo mặc định. Để sử dụng, bạn cần bật nó trong tệp cấu hình.

  • Địa chỉ: POST /v1/chat/completions
  • Cổng: Cùng cổng với Gateway (Ví dụ: http://localhost:18789/v1/chat/completions).

Về bản chất, các yêu cầu gửi đến đây sẽ được thực thi như một lượt chạy Agent bình thường trong Moltbot.

Xác thực

Sử dụng mã xác thực Gateway của bạn. Gửi mã này trong tiêu đề (header) của yêu cầu: Authorization: Bearer <token_cua_ban>

Chọn Agent

Bạn không cần thêm tiêu đề tùy chỉnh, chỉ cần ghi ID của Agent vào trường model trong yêu cầu OpenAI:

  • model: "moltbot:main" (Dùng Agent tên 'main')
  • model: "agent:beta" (Dùng Agent tên 'beta')

Bật tính năng này

Thêm đoạn sau vào tệp cấu hình moltbot.json:

{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": { "enabled": true }
      }
    }
  }
}

Luồng dữ liệu (Streaming)

Hỗ trợ đầy đủ chế độ stream: true để nhận kết quả ngay khi AI vừa tạo ra từng chữ (Server-Sent Events).


Tài liệu liên quan: Cấu hình hệ thống, Nhà cung cấp AI.