Thiết lập API tùy chỉnh Immersive Translate

Mở cài đặt dịch vụ OpenAI

Trang dịch vụ OpenAI chính thức của Immersive Translate ghi nhận địa chỉ API tùy chỉnh dưới More Settings. Bắt đầu ở đó khi đánh giá endpoint tương thích OpenAI. Ghi phiên bản extension và trình duyệt để kiểm tra sau dựa trên môi trường có thể tái tạo.

Chọn một cấu hình cho lần test đầu và giữ cài đặt mặc định khả dụng để khôi phục. Chỉ nhập credential trong cài đặt extension riêng tư. Xác nhận endpoint là người nhận dự kiến trước khi gửi nội dung trang, nhất là khi trình duyệt cũng có quyền vào màn hình quản trị merchant.

Kiểm tra địa chỉ là base hay route đầy đủ

Đừng giả định mọi trường địa chỉ tùy chỉnh hoạt động như baseURL SDK. Trang chính thức đưa URL chat-completions đầy đủ trong ví dụ Azure. Kiểm tra trợ giúp của extension đã cài và đường request đi ra đã làm sạch để xác định địa chỉ được dùng thế nào.

Với ứng viên chat-completions APIsRouter, route đầy đủ là https://api.apisrouter.com/v1/chat/completions. Nếu phiên bản cài rõ ràng cần base URL rồi tự thêm route, dùng https://api.apisrouter.com/v1. Tránh hậu tố chat/completions trùng. Worksheet bên dưới mô tả cài đặt ứng viên, không phải cấu hình extension đã kiểm thử.

Service: OpenAI
Settings area: More Settings > custom API address
Full request URL candidate: https://api.apisrouter.com/v1/chat/completions
Base-only candidate, if required by installed version: https://api.apisrouter.com/v1
Credential: gateway key entered privately
Model: exact current catalog ID with verified chat behavior

Giữ đường request dịch hiển thị

Extension gửi request dịch tới địa chỉ dịch vụ được chọn. Coi địa chỉ là quyết định chia sẻ dữ liệu, không chỉ trường kết nối. Dùng nội dung bạn sở hữu hoặc được phép xử lý qua endpoint chọn, và rà soát hành động dịch đã chọn bao gồm bao nhiêu nội dung trang.

Flow bên dưới minh họa đường gateway đề xuất dùng cơ chế địa chỉ tùy chỉnh được ghi nhận. Nhãn model đã chọn là lựa chọn cấu hình, không phải danh sách model xác minh. Xác thực cửa hàng, chỉnh sửa sản phẩm và phê duyệt nhập nằm ngoài đường request.

Xác minh một trang có kiểm soát trước

Dùng trang ngắn có mô tả sản phẩm tổng hợp, thuật ngữ thương hiệu được bảo vệ, số lượng kèm đơn vị và một liên kết. Chỉ dịch trang đó. So sánh kết quả hiển thị với nguồn và kiểm tra đích mạng đã làm sạch, model đã chọn cùng status response.

Kiểm tra nội dung có bị bỏ, lặp hay trộn với ngôn ngữ nguồn không. Sau đó thử đoạn dài hơn và layout có tiêu đề hoặc danh sách. Lưu nguồn cùng output quan sát để thay đổi cấu hình sau có thể so với cùng tài liệu. Điều này tạo baseline chẩn đoán hữu ích trước khi xử lý tài liệu lớn.

Dùng đọc song ngữ cho câu hỏi biên tập

Dịch trình duyệt giúp người rà soát kiểm tra nguồn lạ hoặc tìm câu cần chú ý. Giữ bản gốc hiển thị và so sánh trực tiếp khẳng định, số lượng cùng thuật ngữ. Nếu người rà soát không đánh giá được ngôn ngữ đích, chuyển ứng viên cho người có thể thay vì coi vẻ trôi chảy là bằng chứng.

Giữ quyết định thuật ngữ trong quy trình catalog. Đừng giả định endpoint tùy chỉnh cũng cung cấp ép bảng thuật ngữ hay xác thực cấp trường bên trong extension. Mô tả sản phẩm định nhập vẫn cần ứng viên liên kết nguồn, kết quả rà soát và ánh xạ điểm đến riêng.

Chẩn đoán lỗi trước khi dịch thêm

Bắt đầu bằng đường request, credential và model ID chính xác. Ghi lỗi có cấu trúc khi có, làm sạch header trước khi chia sẻ bằng chứng. Nếu request bị giới hạn, giảm khối lượng và tôn trọng hướng dẫn retry của dịch vụ thay vì nhanh chóng lặp dịch cả trang.

Dùng đoạn chọn nhỏ hơn để phân biệt lỗi kết nối với vấn đề nội dung hoặc xử lý response. Đổi từng cài đặt một. Trang chính thức có ví dụ giá và tốc độ lịch sử; dùng tài liệu endpoint và giới hạn tài khoản hiện tại thay vì sao chép số đó vào setup mới.

Tách output trình duyệt khỏi bàn giao catalog

View trình duyệt đã dịch là bề mặt kiểm tra. Để xuất bản văn bản sản phẩm, tạo ứng viên trong gói rà soát catalog, giữ mã định danh và bản sửa đổi nguồn, rồi chuyển trường đã duyệt qua API nhập hoặc dịch thực tế của cửa hàng.

Xác minh bàn giao bằng cách đọc trường lưu và mở locale storefront dự kiến. Đừng dựa extension trình duyệt của biên tập viên để chứng minh khách truy cập bình thường sẽ thấy gì. Ghi usage request dịch riêng với vận hành cửa hàng và tính lần thử khi đánh giá khối lượng. Xem giá hiện tại thay vì giả định phí cố định mỗi trang hoặc ký tự.

Bằng chứng và giới hạn tích hợp

Tài liệu chính thức xác lập cài đặt địa chỉ tùy chỉnh. Request extension đã cài qua APIsRouter chưa được kiểm thử cho bài này, nên hành vi địa chỉ chính xác, khả năng tương thích model và kết quả render vẫn là các kiểm tra setup. Sơ đồ là flow cấu hình minh họa.

Hồ sơ tương thích hoàn chỉnh nên có phiên bản extension và trình duyệt, cài đặt đã làm sạch, đích request, model chính xác, trang nguồn có kiểm soát và bản dịch quan sát. Giữ rà soát trường được bảo vệ riêng với kiểm tra transport. Đoạn ngắn thành công không tự động xác thực mọi format tài liệu hoặc quy trình xuất bản cửa hàng.

Câu hỏi thường gặp