Tích hợp

Kết nối những công cụ đội của bạn đang dùng.

Hướng các ứng dụng khách tương thích và quy trình API đến New API một lần. Giữ những công cụ quen thuộc trong khi tổ chức của bạn kiểm soát quyền truy cập mô hình, mức sử dụng và chi phí.

Trước khi bạn kết nối

Chuẩn bị lộ trình truy cập trước.

Một tích hợp đáng tin cậy bắt đầu từ người phụ trách rõ ràng, một mô hình đã phê duyệt và một khóa có thể thu hồi mà không cần thay đổi mã ứng dụng.

Xác nhận người phụ trách

Chỉ định người phụ trách không gian làm việc hoặc dự án, người có thể phê duyệt mô hình, rà soát mức sử dụng và phản hồi khi yêu cầu bị chặn.

Phê duyệt mô hình

Kiểm tra danh mục mô hình và xác nhận rằng năng lực, bối cảnh và tuyến nhà cung cấp phù hợp với quy trình dự định.

Đặt hạn mức

Đặt một ranh giới sử dụng rõ ràng cho khóa hoặc đội trước khi kết nối trình soạn thảo, agent hoặc dịch vụ dùng chung.

Ứng dụng khách tương thích

Một lộ trình được quản lý cho công việc AI hằng ngày.

Sử dụng New API từ trình soạn thảo, terminal hoặc ứng dụng khách API tương thích phù hợp với quy trình.

VS Code

Quy trình AI dựa trên trình soạn thảo

Codex

Quy trình agent và terminal

Claude Code

Quy trình tương thích Anthropic

Trae

Quy trình trình soạn thảo ưu tiên AI

Zcode

Quy trình trợ lý lập trình

Ứng dụng khách tương thích

Cấu hình tương thích OpenAI

Cấu hình cẩn thận

Giữ cho thông tin xác thực và hành vi yêu cầu có thể dự đoán được.

Việc tích hợp nên dễ kiểm thử đối với nhà phát triển và dễ rà soát đối với quản trị viên.

Dùng khóa phía máy chủ

Lưu khóa API New API trong một biến môi trường hoặc trình quản lý bí mật. Không bao giờ đặt nó trong mã trình duyệt, kho mã nguồn hoặc nhật ký yêu cầu.

Khớp định dạng yêu cầu

Chọn endpoint khớp với họ mô hình, sau đó giữ mã định danh model và các trường bắt buộc trong phần thân yêu cầu.

Thử một yêu cầu nhỏ

Bắt đầu với một yêu cầu đại diện, khối lượng thấp. Xác nhận phản hồi, bản ghi sử dụng, hành vi hạn mức và xử lý lỗi trước khi triển khai.

Điều phối agent

Để các agent gọi công cụ qua một lộ trình được quản trị.

Một agent có thể lập kế hoạch tác vụ, truy xuất bối cảnh và gọi một mô hình đã phê duyệt trong khi New API giữ thông tin xác thực, quyền truy cập mô hình và dấu vết yêu cầu dưới cùng các kiểm soát vận hành.

Yêu cầu tác vụ

Agent

Truy xuất bối cảnh

Lệnh gọi mô hình

Kết quả đã rà soát

Lộ trình tích hợp rõ ràng

Từ cấu hình đến kết quả đầu ra được quản trị.

Chọn một mô hình đã phê duyệt

Chọn một mô hình và năng lực mà tổ chức của bạn đã cung cấp.

Thiết lập endpoint tương thích

Cấu hình ứng dụng khách với endpoint New API và khóa API được quản lý.

Rà soát mức sử dụng trong bối cảnh

Dùng bản ghi yêu cầu, hạn mức và dữ liệu sử dụng trước khi mở rộng quyền truy cập.

Câu hỏi thường gặp về tích hợp

Câu trả lời thiết thực trước khi lên sản xuất.

Dùng những câu trả lời này để lập kế hoạch cho lần kết nối đầu tiên. Tài liệu tham chiếu API vẫn là nguồn chính xác nhất cho các trường endpoint và hành vi riêng của nhà cung cấp.

Chúng ta nên bắt đầu từ đâu?

Bắt đầu với một quy trình có người phụ trách, một mô hình đã phê duyệt và một khóa thử nghiệm. Kết nối nó trong môi trường phi sản xuất, xác minh phản hồi và bản ghi sử dụng, sau đó mở rộng có chủ đích.

Làm thế nào để chúng tôi chọn base URL và endpoint?

Dùng base URL New API được cung cấp cho không gian làm việc của bạn và chọn endpoint tương thích cho họ mô hình. Tài liệu tham chiếu API liệt kê các đường dẫn, header bắt buộc và trường yêu cầu hiện hành.

Khóa API nên được đặt ở đâu?

Giữ nó trên máy chủ hoặc trong kho bí mật của công cụ khách, được cung cấp qua biến môi trường khi có thể. Không để lộ nó trong gói frontend, hệ thống quản lý mã nguồn, ảnh chụp màn hình hoặc nhật ký.

Các định dạng OpenAI, Anthropic và Gemini có thể thay thế cho nhau không?

Chúng không thể thay thế cho nhau đối với mọi mô hình. New API hỗ trợ các định dạng tương thích khi phù hợp, bao gồm Chat Completions, Responses, Anthropic Messages và Gemini GenerateContent. Hãy kiểm tra tài liệu về mô hình và endpoint trước khi chuyển đổi định dạng.

Làm thế nào để chúng tôi biết những mô hình nào có sẵn?

Dùng danh mục mô hình và quyền của không gian làm việc cùng nhau. Một mô hình có thể xuất hiện trong danh mục nhưng vẫn cần quản trị viên ủy quyền cho đội hoặc khóa của bạn.

Chúng ta nên xử lý các lỗi 401, 403, 404 hoặc 429 như thế nào?

Kiểm tra khóa và header cho lỗi 401, quyền hoặc quyền truy cập mô hình cho lỗi 403, đường dẫn và tính tương thích của mô hình cho lỗi 404, và hạn mức hoặc giới hạn tốc độ cho lỗi 429. Giữ lại ID yêu cầu và xem API Reference hoặc kênh hỗ trợ đối với các lỗi kéo dài.

Chúng ta nên xử lý các giới hạn trong môi trường sản xuất như thế nào?

Đặt hạn mức trước khi ra mắt, dùng số lần thử lại có giới hạn với thời gian chờ tăng dần cho các phản hồi tạm thời, và theo dõi mức sử dụng cùng tỷ lệ lỗi. Không thử lại một cách mù quáng các lỗi xác thực hoặc quyền.

Khi nào chúng ta nên đọc tài liệu tham chiếu API?

Hãy dùng nó khi bạn cần đường dẫn endpoint chính xác, header, lược đồ yêu cầu, hành vi streaming, trường media hoặc các ràng buộc riêng của nhà cung cấp. Trang này giải thích quy trình tích hợp; tài liệu tham chiếu định nghĩa hợp đồng.