Xác thực
Khóa API
Yêu cầu suy luận được xác thực bằng khóa API của UberLLM. Các khóa bắt đầu bằng ull_ theo sau là một hậu tố ngẫu nhiên. Truyền nó dưới dạng bearer token:
Authorization: Bearer ull_your_key_here
Giao diện Anthropic cũng chấp nhận khóa trong header x-api-key.
Khóa đầu tiên của bạn được tạo sẵn khi bạn truy cập bảng điều khiển lần đầu và được hiển thị cùng với một lệnh gọi đầu tiên mà bạn có thể dán. Tạo, chỉnh sửa, liệt kê và xóa khóa trong Dashboard → API Keys. Khóa bí mật đầy đủ chỉ được hiển thị một lần khi tạo — hãy lưu trữ nó ngay lập tức; UberLLM chỉ lưu giữ một hash và không bao giờ có thể hiển thị lại. Xóa một khóa (Dashboard → API keys → Delete) có hiệu lực ngay lập tức: các ứng dụng sử dụng nó sẽ ngừng hoạt động và mức sử dụng trước đây của nó vẫn được giữ trong tổng số của bạn.
Điều khiển theo khóa
Mỗi khóa có thể có các giới hạn riêng, được đặt khi bạn tạo khóa hoặc sau này bằng cách chọn Chỉnh sửa trên Bảng điều khiển → Khóa API. Một thay đổi sẽ áp dụng cho yêu cầu tiếp theo của khóa.
- Giới hạn chi tiêu — một mức trần bằng USD trong khoảng thời gian
daily,monthlyhoặclifetime. Các yêu cầu vượt quá giới hạn này sẽ bị từ chối với402 key_spend_cap_exceeded. Để trống nghĩa là không giới hạn. - Giới hạn hàng ngày —
daily_limit_usd, ngoài giới hạn chi tiêu. Một yêu cầu phải nằm trong cả hai giới hạn, và giới hạn hàng ngày được đặt lại vào nửa đêm UTC. Một yêu cầu vượt quá bất kỳ giới hạn nào sẽ bị từ chối với402 key_spend_cap_exceededvà không bị tính phí. Đặt nó trên trang Khóa hoặc vớiPATCH /api/v1/keys/{id}. - Giới hạn tốc độ — một mức trần yêu cầu mỗi phút (1 đến 10,000). Để trống nghĩa là giới hạn tiêu chuẩn cho mỗi khóa (300 mỗi phút).
- Nhà cung cấp BYOK — ghim khóa để định tuyến qua thông tin xác thực nhà cung cấp của riêng bạn (xem bên dưới).
Email số dư thấp
Trên Dashboard → Credits, bạn có thể yêu cầu nhận email khi số dư của bạn xuống dưới một số tiền bạn chọn. Tính năng này tắt theo mặc định, gửi một email mỗi khi số dư giảm xuống dưới số tiền đó và gửi đến chủ sở hữu tài khoản. Nếu số tiền dành cho yêu cầu hình ảnh, video, âm nhạc hoặc giọng nói vẫn bị giữ 15 phút sau khi công việc kết thúc, chủ sở hữu tài khoản sẽ nhận được một email liệt kê các công việc đó và đội ngũ của chúng tôi cũng được thông báo. Số tiền đó vẫn là của bạn và sẽ được giải phóng.
BYOK — Mang khóa của riêng bạn
Thêm thông tin xác thực của nhà cung cấp trong mục Dashboard → BYOK. Các yêu cầu được định tuyến qua nhà cung cấp BYOK sẽ sử dụng trực tiếp thông tin xác thực của bạn; không có tín dụng nào được giữ lại và chi phí mỗi token là không trên số dư UberLLM của bạn. Thông tin xác thực đã lưu được mã hóa và chỉ hiển thị dưới dạng -4 ký tự cuối cùng (đã che).
Phiên Dashboard
Bạn đăng nhập vào Dashboard trên web bằng Google (một cú nhấp chuột: lời nhắc "Continue as" trên uberllm.dev, hoặc nút Google), hoặc bằng email của bạn: chúng tôi gửi một mã 6 chữ số (và một liên kết đăng nhập) hết hạn sau 15 phút. Không có mật khẩu. Việc đăng nhập tạo ra một phiên tồn tại trong thời gian ngắn, được lưu trữ trong một httpOnly cookie. Phiên này tách biệt với ull_ inference keys của bạn — các endpoint của Dashboard dưới /api/v1/* sử dụng cookie; gateway (/v1/*) sử dụng API key.
Lỗi
Lỗi xác thực sẽ trả về một cấu trúc lỗi kiểu OpenAI:
{ "error": { "code": "invalid_api_key", "message": "…", "type": "authentication_error" } }
Xem Lỗi & giới hạn để biết danh sách đầy đủ.