Immersive Translate 사용자 지정 API 설정

OpenAI 서비스 설정을 여세요

Immersive Translate의 공식 OpenAI 서비스 페이지는 More Settings 아래의 사용자 지정 API 주소를 문서화합니다. OpenAI 호환 엔드포인트를 평가할 때 여기서 시작하세요. 나중의 설정 확인이 재현 가능한 환경을 가리키도록 확장 프로그램 버전과 브라우저를 기록합니다.

첫 테스트에는 구성 하나를 선택하고 복구를 위해 기본 설정을 사용할 수 있게 유지하세요. 자격 증명은 비공개 확장 프로그램 설정에만 입력합니다. 특히 브라우저가 판매자 관리 화면에도 접근할 수 있을 때 페이지 콘텐츠를 보내기 전에 엔드포인트가 의도한 수신자인지 확인하세요.

주소가 base인지 전체 경로인지 확인하세요

모든 사용자 지정 주소 필드가 SDK baseURL처럼 동작한다고 가정하지 마세요. 공식 페이지의 Azure 예시에는 전체 chat-completions URL이 포함되어 있습니다. 설치된 확장 프로그램의 도움말과 비식별화한 발신 요청 경로를 검사해 주소가 어떻게 사용되는지 확인하세요.

APIsRouter chat-completions 후보의 전체 경로는 https://api.apisrouter.com/v1/chat/completions입니다. 설치된 버전이 base URL을 명시적으로 기대하고 경로를 추가한다면 https://api.apisrouter.com/v1을 사용하세요. chat/completions 접미사가 중복되지 않게 하세요. 아래 워크시트는 후보 설정을 설명하며 테스트된 확장 프로그램 구성은 아닙니다.

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

번역 요청 경로를 보이게 유지하세요

확장 프로그램은 선택한 서비스 주소로 번역 요청을 보냅니다. 그 주소를 단순한 연결 필드가 아니라 데이터 공유 결정으로 다루세요. 선택한 엔드포인트를 통해 처리해도 되는 소유 콘텐츠를 사용하고 선택한 번역 작업이 페이지에서 얼마나 많은 부분을 포함하는지 검토합니다.

아래 흐름은 문서화된 사용자 지정 주소 메커니즘을 사용하는 제안 게이트웨이 경로를 보여줍니다. 선택한 모델 라벨은 확인된 모델 목록이 아니라 구성 선택입니다. 스토어 인증, 제품 편집, 가져오기 승인은 이 요청 경로 밖에 있습니다.

먼저 통제된 페이지 하나를 검증하세요

가상 제품 설명, 보호된 브랜드 용어, 단위가 있는 수량, 링크가 포함된 짧은 페이지를 사용하세요. 해당 페이지만 번역합니다. 보이는 결과를 소스와 비교하고 비식별화한 네트워크 대상, 선택한 모델, 응답 상태를 검사하세요.

콘텐츠가 누락되거나 중복되거나 소스 언어와 섞이는지 확인합니다. 그런 다음 더 긴 문단과 제목 또는 목록이 있는 레이아웃을 시도하세요. 이후 구성 변경을 같은 자료와 비교할 수 있도록 소스와 관찰된 출력을 저장합니다. 대형 문서를 처리하기 전에 유용한 진단 기준선을 얻을 수 있습니다.

편집 질문에는 이중언어 읽기를 사용하세요

브라우저 번역은 검토자가 익숙하지 않은 소스 자료를 확인하거나 주의가 필요한 문구를 찾는 데 도움이 될 수 있습니다. 원문을 보이게 유지하고 주장, 수량, 용어를 직접 비교하세요. 검토자가 대상 언어를 평가할 수 없다면 유창해 보인다는 이유로 승인하지 말고 평가할 수 있는 사람에게 후보를 보내세요.

용어집 결정은 카탈로그 워크플로에 유지하세요. 사용자 지정 엔드포인트가 확장 프로그램 안에서 용어집 강제나 필드 수준 검증도 제공한다고 가정하지 마세요. 가져오기를 위한 제품 설명에는 여전히 자체 소스 연결 후보, 검토 결과, 대상 매핑이 필요합니다.

더 많은 콘텐츠를 번역하기 전에 오류를 진단하세요

요청 경로, 자격 증명, 정확한 모델 ID에서 시작하세요. 가능한 경우 구조화된 오류를 기록하고 근거를 공유하기 전에 헤더를 정제합니다. 요청이 제한되면 전체 페이지 번역을 빠르게 반복하지 말고 작업량을 줄이고 서비스의 재시도 안내를 따르세요.

선택한 문장을 더 작게 만들어 연결 실패와 콘텐츠 또는 응답 처리 문제를 구분합니다. 설정은 한 번에 하나씩 바꾸세요. 공식 페이지에는 과거 가격과 요청 속도 예시가 있으므로 새 설정에 그 숫자를 복사하지 말고 현재 엔드포인트 문서와 계정 제한을 사용하세요.

브라우저 출력과 카탈로그 전달을 분리하세요

번역된 브라우저 화면은 검사 표면입니다. 제품 텍스트를 게시하려면 카탈로그 검토 패키지에서 후보를 만들고 식별자와 소스 리비전을 보존한 뒤 승인된 필드를 스토어의 실제 가져오기 또는 번역 API로 전달하세요.

저장된 필드를 읽고 의도한 스토어프론트 로케일을 열어 전달을 검증하세요. 일반 방문자가 보는 내용을 입증하기 위해 편집자의 브라우저 확장 프로그램에 의존하지 마세요. 번역 요청 사용량은 스토어 작업과 별도로 기록하고 작업량을 평가할 때 재시도를 반영합니다. 페이지 또는 문자당 고정 비용이라고 가정하지 말고 현재 가격을 참조하세요.

근거와 통합의 한계

공식 문서는 사용자 지정 주소 설정을 확립합니다. 이 글을 위해 APIsRouter를 통한 설치된 확장 프로그램 요청은 테스트하지 않았으므로 정확한 주소 동작, 모델 호환성, 렌더링 결과는 설정 확인으로 남아 있습니다. 다이어그램은 구성 예시 흐름입니다.

완료된 호환성 기록에는 확장 프로그램과 브라우저 버전, 비식별화한 설정, 요청 대상, 정확한 모델, 통제된 소스 페이지, 관찰된 번역이 포함되어야 합니다. 보호 필드 검토는 전송 확인과 분리하세요. 짧은 문장이 성공했다고 해서 모든 문서 형식이나 스토어 게시 워크플로가 자동으로 검증되지는 않습니다.

자주 묻는 질문