인증 정보 및 환경#
AI API 요청에는 Ideal House API 계정에 속한 API 키를 사용합니다. 키는 서버에 보관하고 APIKEY 요청 헤더에 담아 전송하세요.
API 키 발급#
- AI API 콘솔에 로그인하세요.
- API 키 관리 기능을 열고 연동에 사용할 키를 생성하거나 선택하세요.
- 서버의 비밀 정보 관리자 또는 환경 설정에 보관하세요. 소스 관리 저장소에 커밋하거나 브라우저 번들에 포함하지 마세요.
이 문서를 읽는 것만으로 API 키가 생성되거나 계정 접근 권한이 부여되지는 않습니다.
요청 환경 설정#
선택한 API 참조 문서에 명시된 기본 URL과 요청 경로를 사용하세요. 예를 들어 https://api.ideal.house를 명시한 참조 문서는 문서 URL이 아닌 해당 API 호스트를 사용합니다.
API 키는 IDEALHOUSE_API_KEY와 같은 서버 전용 환경 변수에 보관하세요. 이는 애플리케이션에서 사용할 수 있는 변수 이름의 예시이며 SDK 설정이 아닙니다. 서버에서 자리표시자를 교체한 다음 요청에 아래 헤더를 포함하세요.
APIKEY: YOUR_API_KEY
엔드포인트에 필요한 콘텐츠 유형, 필드 및 이미지 입력 형식을 따르세요. 비동기 작업에서는 반환된 작업 ID를 보관하고 해당 작업의 문서에 명시된 결과 엔드포인트를 사용하세요.
개발 및 운영 환경#
키를 비공개로 유지할 수 있도록 백엔드를 통해 로컬 테스트를 실행하세요. 배포 전에 비밀 정보를 설정하고 요금, 작업 제한 및 크레딧 차감을 확인하세요. 테스트 요청에도 계정 크레딧이 사용될 수 있습니다. 이 가이드는 별도의 무료 샌드박스를 보장하지 않습니다.
판매자 Shop ID, Publishable Key 및 상품 가져오기용 Client Secret은 Visualizer SDK 연동에 사용됩니다. AI API 키를 대신할 수는 없습니다. 판매자 대시보드의 Allowed Origins (CORS) 설정은 시각화 연동용이며, 서버 측 AI API 요청을 설정하는 단계가 아닙니다.
인증 확인#
빠른 시작을 따른 다음 작업별 응답을 확인하세요. 인증에 실패하면 APIKEY 헤더를 검증하고 오류 코드를 참고하세요. 로그와 지원 요청용 스크린샷에서 키를 제거하세요.