Tài khoản doanh nghiệp

Tài khoản doanh nghiệp cho phép cả nhóm chi tiêu từ một số dư duy nhất. Số dư của tài khoản chủ sở hữu trở thành số dư doanh nghiệp, mỗi thành viên gọi API bằng key của riêng mình, và mọi khoản phí đều trừ vào số dư dùng chung đó. Endpoint, nội dung yêu cầu và cách thiết lập client giống như tài khoản cá nhân; trang này chỉ nói về những gì thay đổi khi bên gọi thuộc về một doanh nghiệp.

Thành viên gửi yêu cầu

acme-…

Bằng key của riêng mình, bắt đầu bằng tiền tố doanh nghiệp.

Kiểm tra hạn mức

Chi phí ước tính phải nằm trong phần hạn mức còn lại của thành viên.

Tính vào doanh nghiệp

Theo giá, nhóm và gói đăng ký của tài khoản chủ sở hữu.

Ghi dưới tên thành viên

Chủ sở hữu và quản trị viên có thể xem chi tiết theo thành viên, model, key và ngày.

Thành viên không bao giờ giữ tiền riêng. Hạn mức chỉ giới hạn số tiền họ có thể chi từ số dư doanh nghiệp.

Vai trò

Vai trò	Tài khoản	Có thể làm gì
Chủ sở hữu	Tài khoản đã gửi đơn đăng ký	Số dư của tài khoản này là số dư doanh nghiệp. Quản lý mọi người, nạp tiền và xem mức sử dụng của toàn doanh nghiệp. Không thể bị vô hiệu hóa.
Quản trị viên	Tạo từ lời mời	Gọi API trong phạm vi hạn mức, mời và quản lý thành viên, nạp tiền và xem mức sử dụng của toàn doanh nghiệp.
Thành viên	Tạo từ lời mời	Dùng API, workbench hình ảnh và video, và Castaly trong phạm vi hạn mức. Không thể nạp tiền.

Quản trị viên và thành viên là các tài khoản mới được tạo từ lời mời qua email. Địa chỉ email được mời không được đăng ký trước đó, vì vậy tài khoản cá nhân hiện có không thể tham gia doanh nghiệp. Các tài khoản này không tham gia các chương trình thưởng của nền tảng.

Chủ sở hữu và quản trị viên có thể vô hiệu hóa một tài khoản bất cứ lúc nào, và phiên đăng nhập cùng các key của tài khoản đó ngừng hoạt động ngay lập tức. Tài khoản chỉ bị vô hiệu hóa, không bao giờ bị xóa, nên lịch sử sử dụng vẫn được giữ lại.

Khóa API

Key doanh nghiệp bắt đầu bằng tiền tố key của doanh nghiệp, ví dụ acme- theo sau là 48 chữ cái và chữ số. Bạn chọn tiền tố khi đăng ký; tiền tố được cố định khi duyệt và không thể đổi sau đó. Tiền tố dài 2 đến 16 ký tự gồm chữ thường và chữ số, bắt đầu bằng chữ cái.

Cùng một key cũng dùng được với sk- thay cho tiền tố. Hãy dùng cách viết này cho client chỉ chấp nhận key bắt đầu bằng sk-: cả hai cách viết đều là cùng một key, với cùng quyền hạn và cách tính phí.

Authorization: Bearer acme-<48 characters>
Authorization: Bearer sk-<48 characters>

Key được gửi kèm tiền tố không thuộc doanh nghiệp của chính nó sẽ bị từ chối như key không hợp lệ với 401.

Các key mà chủ sở hữu tạo trước khi đơn được duyệt cũng hiển thị với tiền tố doanh nghiệp. Cách viết sk- của chúng vẫn hoạt động, nên các tích hợp hiện có không cần thay đổi.

Quản trị viên và thành viên chỉ tạo và thấy key của chính mình trong bảng điều khiển. Chủ sở hữu và quản trị viên có thể quản lý mọi key của doanh nghiệp trong bảng điều khiển doanh nghiệp, lọc theo thành viên.

Hạn mức thành viên

Mỗi quản trị viên và thành viên đều có một hạn mức. Không có tiền nào được chuyển cho họ; hạn mức là số tiền tối đa họ được chi từ số dư doanh nghiệp.

Chế độ	Cách hoạt động
Không giới hạn	Chỉ bị giới hạn bởi số dư doanh nghiệp.
Một lần	Một khoản hạn mức cố định, không bao giờ tự đặt lại.
Hằng tháng	Bắt đầu lại từ 0 lúc 00:00 UTC ngày 1 hằng tháng.

Chỉ thay đổi giới hạn thì số tiền đã dùng được giữ nguyên. Chuyển sang chế độ khác sẽ đếm lại từ đầu.

Trước khi chạy một yêu cầu, gateway giữ trước chi phí ước tính từ hạn mức còn lại của thành viên và từ chối yêu cầu nếu không đủ. Sau đó yêu cầu được quyết toán theo chi phí thực tế. Bước quyết toán không bao giờ từ chối, nên yêu cầu cuối cùng có thể khiến thành viên vượt nhẹ giới hạn; yêu cầu tiếp theo sẽ bị từ chối. Khi yêu cầu thất bại hoặc được hoàn tiền, số tiền cũng được trả lại vào hạn mức của thành viên.

Thành viên nhận email khi đã dùng 80% hạn mức và một lần nữa khi dùng hết.

Thanh toán, nhóm và giới hạn tốc độ

Với gateway, yêu cầu của thành viên chính là yêu cầu từ tài khoản chủ sở hữu. Mọi thứ ngoài hạn mức đều theo chủ sở hữu:

Phí được trừ vào số dư doanh nghiệp giống như khi chủ sở hữu tự gọi, kể cả gói đăng ký của chủ sở hữu.
Giá, nhóm và các model mà một key có thể gọi đều theo tài khoản chủ sở hữu.
Giới hạn tốc độ được tính cho toàn doanh nghiệp. Chủ sở hữu và mọi thành viên dùng chung một hạn ngạch, nên lỗi 429 có thể do lưu lượng của người khác gây ra.

Khi số dư doanh nghiệp hết, yêu cầu của mọi người trong doanh nghiệp đều thất bại với 403 và insufficient_user_quota, giống như tài khoản cá nhân. Chủ sở hữu và quản trị viên có thể nạp tiền từ bảng điều khiển doanh nghiệp; thành viên thì không. Khi đã đặt cảnh báo số dư, chủ sở hữu và quản trị viên sẽ nhận email lúc số dư xuống dưới mức đó.

Lỗi

Tình huống	Trạng thái	Cách nhận biết
Key mang tiền tố của doanh nghiệp khác	`401`	Bị từ chối như key không hợp lệ
Hạn mức của thành viên đã hết	`403`	`code` là `enterprise_member_budget_exhausted`
Thành viên bị vô hiệu hóa, hoặc doanh nghiệp bị tạm ngưng	`403`	`message` cho biết tài khoản đã bị vô hiệu hóa
Số dư doanh nghiệp đã hết	`403`	`code` là `insufficient_user_quota`
Toàn doanh nghiệp chạm giới hạn tốc độ	`429`	Giống như tài khoản cá nhân

Thử lại không khắc phục được các trường hợp 401 và 403. Lỗi hạn mức hết khi quản trị viên nâng giới hạn hoặc, với hạn mức hằng tháng, khi sang tháng mới; lỗi số dư hết sau khi nạp tiền.

Tác vụ bất đồng bộ

Tác vụ được gửi bằng key của một thành viên chỉ có thể truy vấn bằng key của chính thành viên đó. Truy vấn bằng key của thành viên khác sẽ trả về kết quả giống như tác vụ không tồn tại. Key của chủ sở hữu có thể truy vấn tác vụ do bất kỳ ai trong doanh nghiệp gửi.

Mức sử dụng và nhật ký

Mỗi bản ghi nhật ký yêu cầu đều ghi lại thành viên nào đã gửi yêu cầu.
Trong bảng điều khiển của mình, quản trị viên và thành viên chỉ thấy yêu cầu của chính họ.
Trang nhật ký của chủ sở hữu hiển thị yêu cầu của toàn doanh nghiệp, kèm thêm cột Thành viên.
Chủ sở hữu và quản trị viên có thể phân tích chi tiêu theo thành viên, model, key và ngày trong bảng điều khiển doanh nghiệp, và mở từng yêu cầu của bất kỳ thành viên nào.
Khoảng thời gian có thể xem phụ thuộc vào thời hạn lưu nhật ký của tài khoản chủ sở hữu, xem Lưu giữ dữ liệu. Nếu chủ sở hữu rút ngắn thời hạn, báo cáo doanh nghiệp cũng ngắn lại theo.

Đăng ký tài khoản doanh nghiệp

Gửi đơn đăng ký từ bảng điều khiển Modelflare với tên doanh nghiệp, tiền tố key bạn muốn và email liên hệ. Sau khi đơn được duyệt, tài khoản của bạn trở thành chủ sở hữu, số dư của nó trở thành số dư doanh nghiệp, và bạn mời nhóm của mình từ bảng điều khiển doanh nghiệp. Trang Doanh nghiệp mô tả đầy đủ gói dịch vụ.