FAQ

빠른 시작에 따라 로그인, API 키 생성, 모델 선택 및 최소 요청 전송을 진행합니다. 첫 테스트는 OpenAI Chat 호환 호출로 시작하고 기본 연결을 확인한 후 스트리밍 출력, 도구 호출 또는 멀티모달 입력을 추가하는 것을 권장합니다.

토큰은 API Keys에서 생성, 비활성화 또는 삭제합니다. 환경별로 다른 키를 사용하는 것을 권장하며, 사용하지 않거나 유출이 의심되는 키는 즉시 비활성화하거나 삭제해야 합니다.

권장 Base URL은 https://api.agtcloud.cn/v1입니다. OpenAI SDK에서는 base_url 또는 baseURL로 설정하며 OpenAI 호환 API는 일반적으로 Authorization: Bearer your-api-key 인증을 사용합니다. 다른 프로토콜은 해당 API 레퍼런스의 인증 Header 요구 사항을 따릅니다. 자세한 내용은 API 키, Base URL 및 인증을 확인합니다.

권장하지 않습니다. 장기 API 키는 신뢰할 수 있는 서버, 서버 환경 변수 또는 키 관리 서비스에 보관해야 합니다. 브라우저와 모바일 앱은 자체 백엔드에 요청하고 백엔드가 AGTCloud를 호출하여 사용자의 키 추출 및 오용을 방지해야 합니다.

Base URL에 이미 /v1이 있는데 코드에서 엔드포인트 앞에 /v1을 다시 추가하는 경우가 많습니다. SDK Base URL로 https://api.agtcloud.cn/v1을 사용하고 SDK가 /chat/completions 등의 엔드포인트를 자동으로 붙이도록 권장합니다. 문제 해결 시 최종 전송 URL 전체를 확인합니다.

현재 표시되는 모델과 모델 ID는 모델 목록에서 확인합니다. 모델 표시 범위는 플랫폼 설정과 계정 권한에 따라 달라집니다. 호출 시 현재 페이지의 ID를 복사하고 실제 요청 결과를 기준으로 합니다.

원래 공급업체의 프로토콜 의미를 반드시 유지해야 하는 경우가 아니라면 SDK와 연동 방식이 널리 사용되는 OpenAI Chat Completions로 시작할 수 있습니다. 기존 Anthropic, Gemini 또는 Responses 애플리케이션은 SDK와 메시지 구조를 우선 유지한 후 대상 모델의 호환성을 확인합니다.

401은 프로토콜의 인증 Header와 API 키를, 403은 계정, 키 및 모델 권한을, 404는 Base URL, 엔드포인트, 모델 ID 또는 작업 ID를 먼저 확인합니다. 무한 재시도하지 말고 명확한 원인을 먼저 해결합니다. 자세한 절차는 오류 및 문제 해결을 확인합니다.

응답 헤더의 x-request-id, request-id 또는 x-oneapi-request-id를 확인하고 실제 존재하는 값을 저장합니다. 일부 오류 본문에도 Request ID가 있을 수 있습니다. 찾지 못해도 요청 시간, Method, Path, 모델 및 HTTP 상태를 기록해야 합니다. 코드 예시는 Request ID를 확인합니다.

즉시 API Keys에서 기존 키를 비활성화하거나 삭제하고 새 키를 생성하여 해당 서비스에 적용합니다. 코드 저장소, 로그, 스크린샷 및 대화 기록에 복사본이 남아 있는지 확인합니다. Git에 커밋한 적이 있다면 현재 파일만 삭제하지 말고 팀 보안 절차에 따라 이력도 처리해야 합니다.

요청 시간과 시간대, Method, Path, 모델 ID, HTTP 상태, 마스킹된 오류 정보, SDK 및 런타임 버전과 최소 재현 절차를 준비합니다. 응답에 Request ID가 있으면 함께 보관합니다. 전체 API 키, 인증 Header, Cookie, 고객 Prompt 또는 비공개 파일을 제출하지 않습니다.