팀이 이미 사용하는 도구를 연결하세요.

먼저 명확한 접근 경로를 준비하세요.

안정적인 연동에는 담당자, 승인된 모델, 애플리케이션 코드를 바꾸지 않고도 폐기할 수 있는 키가 필요합니다.

• 담당자 확인. 모델 승인, 사용량 검토와 차단된 요청 대응을 맡을 워크스페이스 또는 프로젝트 담당자를 정합니다.
• 모델 승인. 모델 카탈로그에서 기능, 컨텍스트와 공급자 경로가 워크플로에 맞는지 확인합니다.
• 쿼터 설정. 공유 에디터, 에이전트 또는 서비스를 연결하기 전에 키나 팀에 사용량 한도를 지정합니다.

일상적인 AI 작업을 위한 하나의 관리 경로.

에디터, 터미널 또는 호환 API 클라이언트에서 TokenDate를 사용하세요.

• VS Code. 에디터 기반 AI 워크플로
• Codex. 에이전트 및 터미널 워크플로
• Claude Code. Anthropic 호환 워크플로
• Trae. AI 네이티브 에디터 워크플로
• Zcode. 코딩 어시스턴트 워크플로
• 호환 클라이언트. OpenAI 호환 구성

자격 증명과 요청 동작을 예측 가능하게 유지하세요.

개발자는 쉽게 테스트하고 관리자는 연동 상태를 검토할 수 있어야 합니다.

• 서버 측 키 사용. TokenDate API 키를 환경 변수나 시크릿 관리자에 보관하세요. 브라우저 코드, 저장소와 요청 로그에 넣지 마세요.
• 요청 형식 일치. 모델 계열에 맞는 호환 엔드포인트를 선택하고 모델 식별자와 필수 필드를 요청 본문에 유지합니다.
• 작은 요청으로 테스트. 낮은 트래픽의 대표 요청으로 시작해 응답, 사용량 기록, 쿼터 동작과 오류 처리를 확인한 뒤 배포합니다.

설정부터 관리되는 결과까지.

1. 승인된 모델 선택. 조직이 사용할 수 있도록 승인한 모델과 기능을 선택합니다.
2. 호환 엔드포인트 설정. TokenDate 엔드포인트와 관리형 API 키를 클라이언트에 설정합니다.
3. 사용량 검토. 요청 기록, 쿼터와 사용량을 확인한 뒤 액세스를 확대합니다.

어디서 시작해야 하나요?

담당자가 있는 워크플로 하나, 승인된 모델 하나, 테스트 키 하나로 시작하세요. 비프로덕션에서 응답과 사용량 기록을 확인한 뒤 확대합니다.

Base URL과 엔드포인트는 어떻게 고르나요?

워크스페이스에 제공된 TokenDate Base URL을 사용하고 모델 계열에 맞는 호환 엔드포인트를 선택하세요. 경로, 헤더와 필드는 API Reference를 확인합니다.

API 키는 어디에 보관해야 하나요?

서버나 클라이언트 도구의 시크릿 저장소에 보관하고 가능한 경우 환경 변수로 주입하세요. 프론트엔드 번들, 소스, 스크린샷과 로그에 노출하지 마세요.

OpenAI, Anthropic, Gemini 형식은 서로 바꿔 쓸 수 있나요?

모든 모델에서 가능한 것은 아닙니다. 적용 가능한 경우 Chat Completions, Responses, Anthropic Messages와 Gemini GenerateContent를 지원하므로 모델과 엔드포인트 문서를 먼저 확인하세요.

사용 가능한 모델은 어떻게 확인하나요?

모델 카탈로그와 워크스페이스 권한을 함께 확인하세요. 카탈로그에 있어도 팀이나 키에 관리자 승인이 필요할 수 있습니다.

401, 403, 404, 429 오류는 어떻게 처리하나요?

401은 키와 헤더, 403은 권한과 모델 액세스, 404는 경로와 호환성, 429는 쿼터와 속도 제한을 확인하세요. 지속되면 요청 ID를 보관하고 API Reference나 지원 채널을 확인합니다.

프로덕션 한도는 어떻게 다루나요?

출시 전에 쿼터를 설정하고 일시적 응답에는 백오프가 있는 제한적 재시도를 사용하며 사용량과 오류율을 모니터링하세요.

언제 API Reference를 봐야 하나요?

정확한 경로, 헤더, 스키마, 스트리밍, 미디어 필드나 공급자 제약이 필요할 때 확인하세요. 이 페이지는 흐름을 설명하고 Reference는 계약을 정의합니다.