OneMux/Tài liệu/Hỗ trợ giao thức

Hỗ trợ giao thức

OneMux hỗ trợ đồng thời bốn định dạng giao thức: OpenAI, Anthropic, Gemini và Responses API. Nhà phát triển có thể chọn giao thức tối ưu tùy theo đặc tính của mô hình và chuyển đổi mà không cần sửa đổi mã hiện có. Trang này liệt kê endpoint, phương thức xác thực và trường hợp sử dụng của từng giao thức.

Các giao thức được hỗ trợ

Giao thức	Endpoint	Mô hình phù hợp	Phương thức xác thực
Tương thích OpenAI	/v1/chat/completions	Tất cả mô hình	Authorization: Bearer sk-xxx
Anthropic gốc	/v1/messages	Dòng Claude	x-api-key: sk-xxx
OpenAI Responses	/v1/responses	Dòng GPT	Authorization: Bearer sk-xxx
Gemini gốc	/v1beta/models/{model}:generateContent	Dòng Gemini	Authorization: Bearer sk-xxx

Vì sao có nhiều giao thức?

Chi phí chuyển đổi thấp: Không cần sửa mã hiện có, chỉ cần thay đổi Base URL
Đầy đủ tính năng gốc: Hỗ trợ các tính năng như Anthropic Prompt Caching, Claude Extended Thinking và ngữ cảnh Gemini 2M
Hiệu suất tối ưu: Claude chạy qua giao thức Anthropic nhanh hơn 20-30% so với định dạng OpenAI

Cách sử dụng được đề xuất

Mô hình	Giao thức đề xuất	Lý do
Dòng Claude	Anthropic gốc	Hỗ trợ Prompt Caching, giảm 90% chi phí
Dòng GPT	Tương thích OpenAI	Định dạng tiêu chuẩn, khả năng tương thích tốt nhất
Dòng Gemini	Gemini gốc	Hỗ trợ ngữ cảnh 2M, xử lý tài liệu rất dài

Định dạng tương thích OpenAI

curl https://api.onemux.net/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Định dạng Anthropic gốc (khuyên dùng cho Claude)

curl https://api.onemux.net/v1/messages \
  -H "x-api-key: sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Định dạng Gemini gốc

curl https://api.onemux.net/v1beta/models/gemini-4-argon:generateContent \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "Hello"}]
    }]
  }'