FAQ

이 FAQ는 공개용입니다. 지원 챗봇 코퍼스로도 쓸 수 있으며, 내부 운영 정보는 포함하지 않습니다.

시작

Q. 기존 OpenAI 코드를 그대로 쓸 수 있나요? 네. OpenAI 호환이라 base_url과 api_key만 바꾸면 됩니다. 시작하기.

Q. API 키는 어디서 받나요? 포털에서 로그인 → 프로젝트 생성 → API Key 발급. 개발/운영 키를 분리하세요.

Q. 키 없이 체험할 수 있나요? 플레이그라운드가 열려 있으면 키 없이 일부 기능을 체험할 수 있습니다. 운영 호출엔 키가 필요합니다.

모델

Q. 어떤 모델이 있나요? GET /v1/models로 실제 목록을 확인하세요. 채팅·임베딩·리랭커·비전 등이 있습니다.

Q. 어떤 모델을 골라야 하나요? 작업에 맞게: 분류·요약은 소형, 복합 추론은 대형, 한국어는 한국어 강한 모델. 비용·지연.

기능 만들기

Q. RAG(문서 질의응답)는 어떻게 만드나요? rag-document-qa 템플릿을 쓰거나 /v1/embeddings + /v1/rerank + /v1/chat/completions를 조합. RAG 가이드.

Q. 모델이 도구(검색 등)를 호출하게 하려면? 네이티브 tools 또는 프롬프트 ReAct 폴백. 도구 호출.

Q. 템플릿을 조합해 앱을 만들려면? AppSpec을 작성하고 hasa app generate로 프로젝트를 생성한 뒤, 코딩 에이전트로 완성. 빠른 시작.

문제 해결

Q. 401/403이 떠요. → 키를 확인하세요(헤더 Authorization: Bearer). 트러블슈팅. Q. 429가 떠요. → Rate limit 초과. 백오프 재시도 + 한도 상향. Q. 스트림이 한 번에 와요. → 프록시 버퍼링. 스트리밍. Q. 한국어인데 사고 과정이 영어로 나와요. → 추론/작성 모델 분리. 다국어.

운영

Q. 서비스로 만들려면 뭐가 더 필요한가요? 인증·한도·비용계측·안전·배포 등. 프로덕션 체크리스트.

Q. 비밀 키나 관리자 정보를 알려줄 수 있나요? 아니요. 비밀·인프라·계정 정보는 안내하지 않습니다. 계정/권한 문의는 지원 티켓으로 접수해 주세요.