Bỏ qua, tới nội dung
Hydra

AI API

AI API cho phép bạn gọi đúng các mô hình mà khung chat của công ty đang dùng, từ code của chính bạn: một script, một tiện ích cho bảng tính, một công cụ nội bộ, hay bất kỳ ứng dụng nào nói chuyện được với API của OpenAI hoặc Anthropic. Lệnh gọi chạy trên các tài khoản mô hình mà công ty bạn đã kết nối (xem Tài khoản mô hình AI), theo cùng cách chia công bằng như khung chat. Chỗ trống cuối cùng trên mỗi tài khoản luôn được giữ cho khung chat, nên script không bao giờ chen mất phần của đồng nghiệp.

Hiện tại AI API dành cho chủ sở hữu và quản trị viên. Một khóa chỉ dùng được khi người tạo ra nó vẫn giữ một trong hai vai trò đó.

Tạo khóa

  1. Mở Cài đặt → Khóa API AI.
  2. Nhập Tên khóa cho biết khóa sẽ dùng ở đâu, ví dụ laptop hay script báo cáo tuyến, rồi chọn Tạo khóa.
  3. Hydra hiện khóa đúng một lần. Khóa bắt đầu bằng hk_. Sao chép ngay rồi chọn Tôi đã sao chép. Nếu làm mất, hãy thu hồi và tạo khóa khác.

Mỗi người giữ được tối đa 20 khóa. Hydra chỉ lưu dấu vân tay của khóa, không bao giờ lưu chính khóa.

Gọi API

Thay https://hydra.example.com bằng địa chỉ Hydra của công ty bạn.

curl https://hydra.example.com/api/ai/v1/chat/completions \
  -H "Authorization: Bearer hk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Reply with the word PONG"}]}'

Với SDK chính thức, đặt hai biến môi trường:

# Ứng dụng và SDK của OpenAI
export OPENAI_BASE_URL=https://hydra.example.com/api/ai/v1
export OPENAI_API_KEY=hk_YOUR_KEY

# Ứng dụng và SDK của Anthropic (SDK tự thêm /v1)
export ANTHROPIC_BASE_URL=https://hydra.example.com/api/ai
export ANTHROPIC_API_KEY=hk_YOUR_KEY

Khóa đặt trong Authorization: Bearer, hoặc trong x-api-key như cách các ứng dụng Anthropic gửi.

Các cổng gọi

Cổng Dạng Làm gì
GET /api/ai/v1/models OpenAI Các mô hình khóa này được dùng: auto, cùng các mã mà thiết lập mô hình của công ty cho phép bạn.
POST /api/ai/v1/chat/completions OpenAI Trả lời từ messages.
POST /api/ai/v1/messages Anthropic Trả lời từ system và messages.
GET /api/ai/v1/usage JSON Tổng số liệu của khóa trong hôm nay và 30 ngày qua.
POST /api/ai/v1/images/generations OpenAI Tạo ảnh từ câu mô tả, một hoặc hai ảnh mỗi lần, khi máy chủ của bạn đã bật tính năng tạo ảnh.

Dùng auto để Hydra tự chọn mô hình, hoặc một mã lấy từ /models. Cả hai dạng đều hỗ trợ trả về từng phần ("stream": true).

Một lệnh gọi làm được gì, không làm được gì

API trả lời bằng chữ. Lệnh gọi không có công cụ, không có tệp, không có trí nhớ: không đọc được Drive, không chạm vào ERP, không duyệt web. Mỗi lệnh gọi đứng riêng; muốn có hội thoại, hãy gửi kèm các lượt trước trong messages.

Giới hạn Mức
Thời gian một lệnh gọi 5 phút
Dữ liệu đầu vào 200.000 ký tự
Số lệnh chạy cùng lúc 2 mỗi khóa, 4 mỗi người
Số yêu cầu mỗi phút 20 mỗi khóa

Khi vượt giới hạn, hoặc khi mọi tài khoản đều bận, bạn nhận mã 429 kèm header Retry-After, thay vì phải xếp hàng sau mọi người trong khung chat. Các mã khác có thể gặp: 401 khi khóa sai hoặc đã bị thu hồi, 403 khi chủ khóa không còn là chủ sở hữu hay quản trị viên, 404 khi mô hình không tồn tại, 503 khi không tài khoản nào phục vụ được, 504 khi lệnh gọi hết giờ. Lỗi trả về đúng dạng của cổng bạn gọi, nên SDK đọc được như thường.

Số liệu theo từng khóa

Mỗi khóa trong Cài đặt → Khóa API AI hiện lần dùng gần nhất, số yêu cầu và số token trong hôm nay, có đếm riêng số lần lỗi. GET /api/ai/v1/usage trả về số liệu tương tự cho hôm nay và 30 ngày qua: số yêu cầu, số lỗi, token đầu vào và đầu ra. Lệnh gọi API được tính vào mức dùng của chính bạn, cạnh các cuộc chat, trong Hệ thống → Mức dùng.

Thu hồi khóa

Chọn Thu hồi ở khóa đó, rồi Thu hồi ngay. Khóa ngừng hoạt động lập tức: lệnh gọi kế tiếp sẽ nhận 401. Hãy thu hồi ngay khi mất laptop hoặc khi một script không còn dùng. Thu hồi một khóa không ảnh hưởng các khóa khác của bạn.

Những gì được ghi lại

Mọi lệnh gọi đều nằm trong nhật ký kiểm toán với tên ai.call, kèm khóa, mô hình, thời gian chạy, trạng thái và số token. Câu hỏi và câu trả lời không bao giờ được ghi. Việc tạo và thu hồi khóa cũng được ghi lại.