Tổng quan
Dự án giúp tổ chức công việc trong một tổ chức API. Dùng dự án để quản lý quyền truy cập, cấu hình giới hạn mô hình và giới hạn tốc độ, tạo tài khoản dịch vụ, cũng như theo dõi mức sử dụng, thông tin thanh toán và giới hạn chi tiêu cho một tập hợp tài nguyên xác định, chẳng hạn như mô hình, tính năng, luồng hội thoại, trợ lý, tinh chỉnh và bộ nhớ lưu trữ.
Chủ sở hữu tổ chức có thể xem tất cả dự án đang hoạt động và đã lưu trữ trên trang Dự án.
Trước khi bắt đầu
Bạn cần có vai trò chủ sở hữu tổ chức để tạo dự án. Theo mặc định, mỗi tổ chức có thể tạo tối đa 2.000 dự án.
Nếu tổ chức của bạn sử dụng hình thức thanh toán hợp nhất, các tổ chức con sẽ xuất hiện riêng trong bộ chọn tổ chức. Bạn không thể tạo dự án trong tổ chức con.
Để chuyển tổ chức, hãy mở bộ chọn tổ chức và chọn tổ chức bạn muốn sử dụng.
Dự án Mặc định
Mỗi tổ chức đều có một dự án Mặc định không thể xóa. Dự án này kế thừa toàn bộ cấu hình của tổ chức. Bạn có thể cấu hình giới hạn tốc độ, quyền đối với mô hình ảo và giới hạn chi tiêu của dự án này.
Bạn không thể thêm trực tiếp thành viên hoặc tài khoản dịch vụ vào dự án Mặc định. Bạn có thể cấp kèm quyền truy cập dự án Mặc định khi mời ai đó vào tổ chức, theo các bước mời tham gia tổ chức trong bài viết này.
Tạo dự án
Mở bộ chọn dự án và chọn Tạo dự án.
Nhập tên, mô tả và trang web cho dự án của bạn.
Chọn Tạo.
Chủ sở hữu tổ chức được tự động thêm làm chủ sở hữu của các dự án mới.
Tìm hiểu vai trò và quyền truy cập
Bảng này tóm tắt các vai trò chủ sở hữu và người đọc ở cấp tổ chức, cùng các vai trò chủ sở hữu và thành viên ở cấp dự án được dùng trong các bước hướng dẫn này. Thành viên dự án có quyền tương tự người đọc của tổ chức.
| Vai trò | Phạm vi | Quyền |
|---|---|---|
| Chủ sở hữu | Tổ chức | Tạo và xem tất cả dự án, người dùng và khóa API. Theo dõi dự án trên trang Dự án. Đặt giới hạn chi tiêu cho tổ chức và dự án. Cấp quyền truy cập thông tin sử dụng của người dùng khác. Lưu trữ dự án. |
| Người đọc | Tổ chức | Được thêm vào dự án, thực hiện suy luận, sử dụng tài nguyên và tạo khóa trong các dự án đó. Không thể tạo dự án hoặc quản lý người dùng. |
| Chủ sở hữu | Dự án | Có tất cả quyền của thành viên, đồng thời có thể thêm người dùng, quản lý thành viên và cài đặt dự án, đổi tên dự án, đặt giới hạn chi tiêu và lưu trữ dự án. |
| Thành viên | Dự án | Thực hiện suy luận, sử dụng tài nguyên, tạo khóa cấp dự án và gửi yêu cầu API để đọc hoặc sửa đổi dữ liệu. |
Để biết chi tiết về các vai trò trong tổ chức, hãy xem: vai trò trong tổ chức. Để tìm hiểu về các vai trò bổ sung, vai trò tùy chỉnh và đầy đủ các quyền, hãy xem hướng dẫn về vai trò và quyền API.
Quyền xem dự án
Với các vai trò tiêu chuẩn này, người dùng không phải là chủ sở hữu tổ chức chỉ có thể thấy các dự án mà họ tham gia. Chủ sở hữu tổ chức có thể thấy tất cả dự án, thành viên và khóa API cấp dự án, đồng thời có thể truy cập trang Dự án.
Thành viên dự án có thể thấy các thành viên khác trong dự án và vai trò của từng người. Chỉ thành viên dự án và chủ sở hữu tổ chức mới có thể thấy các mô hình được tinh chỉnh, luồng hội thoại của trợ lý và tệp được tạo hoặc thêm vào dự án đó.
Bạn có thể tham gia bao nhiêu dự án tùy nhu cầu. Khóa API cá nhân được tạo trong một dự án chỉ có phạm vi sử dụng trong dự án đó và các tài nguyên của dự án.
Phạm vi tài nguyên
Tệp, trợ lý, bộ nhớ lưu trữ và luồng hội thoại được giới hạn trong phạm vi dự án của chúng. Thành viên không có quyền quản trị và không thuộc dự án đó không thể truy cập tài nguyên của dự án. Các tài nguyên cũng không thể được chuyển giữa các dự án.
Các mô hình được tinh chỉnh trong dự án Mặc định là ngoại lệ: bạn có thể truy cập chúng từ các dự án khác.
Quản lý thành viên dự án
Mời người khác vào tổ chức của bạn
Một người phải là thành viên của tổ chức trước khi bạn có thể thêm họ vào dự án.
Khi mời ai đó vào tổ chức, bạn có thể cấp kèm quyền truy cập dự án Mặc định bằng cách chọn tùy chọn đó trong biểu mẫu mời. Để trống tùy chọn này nếu bạn không muốn cấp quyền truy cập dự án Mặc định. Thành viên mới của tổ chức không được tự động thêm vào dự án Mặc định.
Bạn không cần tạo dự án khác trước khi mời ai đó. Bạn cũng có thể thêm người đó vào dự án sau khi họ chấp nhận lời mời tham gia tổ chức.
Lời mời gửi qua API quản trị tuân theo các quy tắc của điểm cuối /organization/invites.
Thêm thành viên tổ chức vào dự án
Chủ sở hữu tổ chức và dự án có thể thêm thành viên:
Truy cập phần cài đặt tổ chức.
Chọn dự án, rồi mở Thành viên.
Chọn + Thêm thành viên.
Chọn người dùng và gán vai trò Thành viên hoặc Chủ sở hữu.
Danh sách người dùng hiển thị những người dùng trong tổ chức có vai trò Người đọc. Danh sách này không bao gồm tài khoản dịch vụ.
Nếu gửi lời mời không thành công trên giao diện người dùng hoặc qua API quản trị, hãy xác nhận rằng dự án đích tồn tại và chưa được lưu trữ trước khi gửi lại lời mời.
Thay đổi vai trò hoặc xóa thành viên
Chủ sở hữu tổ chức và dự án có thể thay đổi vai trò của người dùng trong dự án hoặc xóa người dùng khỏi dự án đó.
Truy cập phần cài đặt tổ chức.
Chọn dự án, rồi mở Thành viên.
Đặt vai trò của người dùng thành Thành viên hoặc Chủ sở hữu, hoặc chọn Xóa để xóa họ.
Tạo và quản lý tài khoản dịch vụ
Tài khoản dịch vụ cung cấp quyền truy cập cho hệ thống thay vì đại diện cho một người dùng cá nhân. Tài khoản dịch vụ được giới hạn trong phạm vi dự án.
Việc tạo tài khoản dịch vụ yêu cầu quyền quản lý tài khoản dịch vụ. Chủ sở hữu tổ chức và dự án có các quyền này.
Tạo tài khoản dịch vụ
Chọn dự án trong bộ chọn dự án.
Truy cập phần cài đặt tổ chức và chọn dự án.
Mở Thành viên và chọn + Tài khoản dịch vụ.
Nhập ID tài khoản dịch vụ duy nhất, sử dụng chữ cái, chữ số và dấu gạch nối.
Chọn Tạo.
Tài khoản dịch vụ được tạo ở cấp dự án là duy nhất cho dự án đó và không thể được sử dụng bên ngoài dự án mà chúng được tạo trong đó.
Định dạng ID là như nhau dù bạn tạo tài khoản dịch vụ từ phần cài đặt cấp tổ chức hay cấp dự án.
Tài khoản dịch vụ được tạo cho một dự án chỉ dành riêng cho dự án đó và không thể dùng bên ngoài dự án.
Lưu khóa bí mật
Khi bạn tạo tài khoản dịch vụ, hệ thống lập tức tạo một khóa API và hiển thị khóa bí mật của khóa đó. Hãy lưu khóa bí mật ở nơi an toàn. Bạn không thể xem lại khóa này qua tài khoản OpenAI của mình. Nếu làm mất, hãy tạo khóa mới.
Theo mặc định, khóa của tài khoản dịch vụ có thể đọc và ghi tất cả tài nguyên API trong dự án của tài khoản đó. Bạn có thể thay đổi các quyền đó sau này trong phần cài đặt Khóa API của dự án.
Cập nhật hoặc xóa tài khoản dịch vụ
Tài khoản dịch vụ xuất hiện cùng với người dùng trong phần cài đặt Thành viên của dự án. Quản lý quyền truy cập dự án của các tài khoản này bằng các bước thay đổi vai trò và xóa giống như với các thành viên khác của dự án.
Tất cả tài khoản dịch vụ cũng xuất hiện cùng với người dùng trên trang Thành viên của tổ chức, bao gồm cả tài khoản được tạo từ phần cài đặt cấp tổ chức và cấp dự án.
Từ menu Thành viên của tổ chức, bạn có thể thay đổi vai trò của tài khoản dịch vụ hoặc chọn Xóa.
Tạo và quản lý khóa API
Mỗi dự án có các khóa API riêng:
Truy cập phần cài đặt tổ chức.
Chọn dự án, rồi mở Khóa API.
Chọn + Tạo mới khóa bí mật để tạo khóa, hoặc chọn biểu tượng chỉnh sửa bên cạnh khóa hiện có để thay đổi quyền của khóa đó.
Chọn quyền cho khóa
Với khóa thuộc sở hữu của người dùng, bạn có thể đặt quyền khi tạo khóa hoặc chỉnh sửa sau:
Tất cả: Toàn quyền. Đây là tùy chọn mặc định.
Hạn chế: Chọn phạm vi quyền cho các tài nguyên hoặc điểm cuối cụ thể. Các tùy chọn có sẵn tùy thuộc vào tài nguyên và có thể bao gồm Không có, Đọc, Ghi hoặc quyền dành riêng cho từng loại yêu cầu.
Chỉ đọc: Quyền đọc đối với tất cả điểm cuối.
Ví dụ: một khóa có quyền hạn chế có thể không được cấp quyền đọc và ghi đối với điểm cuối /v1/assistants.
Việc tạo khóa cho tài khoản dịch vụ yêu cầu quyền quản lý tài khoản dịch vụ. Nếu không thấy tùy chọn đó, hãy nhờ chủ sở hữu tổ chức hoặc dự án tạo khóa cho tài khoản dịch vụ. Hộp thoại tạo khóa không hiển thị các tùy chọn quyền này cho khóa tài khoản dịch vụ; hãy thay đổi quyền sau đó trong phần cài đặt Khóa API của dự án.
Cấu hình quyền truy cập mô hình và giới hạn tốc độ
Việc quản lý giới hạn tốc độ của dự án yêu cầu quyền quản trị. Chủ sở hữu tổ chức có các quyền này, và chủ sở hữu dự án cũng có thể quản lý giới hạn tốc độ của dự án qua API quản lý.
Truy cập phần cài đặt tổ chức.
Chọn dự án, rồi mở Giới hạn.
Dùng Mức sử dụng mô hình để chọn các mô hình mà dự án được phép sử dụng.
Đặt giới hạn tốc độ cho từng mô hình khi cần.
Đặt giới hạn và cảnh báo chi tiêu
Có thể đặt giới hạn chi tiêu API hằng tháng ở cả cấp tổ chức và cấp dự án. Bạn cần có quyền quản lý cài đặt của tổ chức hoặc dự án tương ứng trước khi thay đổi giới hạn.
Giới hạn chi tiêu có thể dùng để theo dõi chi tiêu mà không chặn yêu cầu. Bật Áp dụng giới hạn cứng nếu bạn muốn các yêu cầu API không được thực hiện khi mức chi tiêu được theo dõi chạm giới hạn. Việc áp dụng giới hạn không diễn ra tức thì, nên mức chi tiêu được ghi nhận có thể vượt nhẹ số tiền đã thiết lập.
Cảnh báo chi tiêu thông báo cho bạn khi chạm ngưỡng; chúng không chặn yêu cầu.
Đặt giới hạn chi tiêu cho tổ chức
Truy cập phần cài đặt tổ chức.
Mở Giới hạn và tìm Chi tiêu.
Đặt giới hạn chi tiêu cho dự án
Truy cập phần cài đặt tổ chức.
Chọn dự án, rồi mở Giới hạn.
Đặt giá trị cho Giới hạn chi tiêu hằng tháng và Cảnh báo khi chi tiêu đạt.
Bật Áp dụng một giới hạn cứng nếu bạn muốn chặn lưu lượng API khi mức chi tiêu được theo dõi chạm giới hạn.
Bạn cũng có thể thay đổi Mức sử dụng mô hình trên trang này.
Quản lý cảnh báo chi tiêu
Khi tạo giới hạn chi tiêu cho dự án, theo mặc định, một cảnh báo cũng được tạo ở ngưỡng 100% giới hạn. Chọn Thêm cảnh báo để thêm cảnh báo ở các ngưỡng khác.
Chủ sở hữu tổ chức và dự án nhận được cảnh báo chi tiêu của dự án. Bạn có thể thêm người nhận email khác trong phần cài đặt cảnh báo.
Để biết các bước cấu hình và cách áp dụng giới hạn hiện tại, hãy xem hướng dẫn về giới hạn chi tiêu.
Xem mức sử dụng và thông tin thanh toán
Hoạt động sử dụng có thể được phân tách theo dự án, và bạn có thể xem thông tin thanh toán cũng như đặt giới hạn chi tiêu cho từng dự án.
Quyền truy cập Bảng điều khiển mức sử dụng của dự án phụ thuộc vào vai trò của bạn trong tổ chức và cài đặt quyền xem Bảng điều khiển mức sử dụng. Chỉ có vai trò chủ sở hữu dự án thì chưa đủ để được cấp quyền truy cập.
Nếu không xem được Bảng điều khiển mức sử dụng của dự án, hãy kiểm tra xem quyền xem có được đặt thành Hiển thị cho chủ sở hữu tổ chức hay không.
Quản lý bộ nhớ lưu trữ tệp
Mỗi dự án có hạn mức lưu trữ tệp là 100 GB. Nếu vượt hạn mức, bạn có thể thấy thông báo lỗi sau:
Bạn đã vượt quá hạn mức lưu trữ tệp. Mỗi tổ chức chỉ được lưu trữ tối đa 100 GB tệp. Vui lòng giảm kích thước tệp hoặc liên hệ bộ phận hỗ trợ.
Xóa các tệp không dùng đến để giải phóng dung lượng lưu trữ. Bạn có thể liệt kê các tệp đã lưu qua API để xác định những tệp không còn cần đến.
Lưu trữ dự án
Chủ sở hữu tổ chức và dự án có thể lưu trữ dự án từ trang Dự án hoặc phần cài đặt của từng dự án. Nhập tên dự án khi được yêu cầu xác nhận.
Thao tác lưu trữ là vĩnh viễn: dự án đã lưu trữ không thể khôi phục.
Để xem các dự án đã lưu trữ, hãy mở thẻ Đã lưu trữ trên trang Dự án.
Ngoại lệ duy nhất là các bản tinh chỉnh trong “Dự án mặc định” có thể được truy cập từ các dự án khác.
Bạn đã vượt quá hạn ngạch lưu trữ tệp. Tổ chức bị giới hạn ở 100 GB tệp. Vui lòng giảm kích thước tệp hoặc liên hệ bộ phận hỗ trợ.Không thể xóa dự án. OpenAI giữ lại lịch sử của dự án để theo dõi mức sử dụng và thông tin thanh toán.