21. 자주 묻는 질문 FAQ#

Q: 기존 OpenAI 코드는 얼마나 수정해야 하나요? A: 보통 baseURL과 apiKey 두 곳만 바꾸면 되며, 나머지 요청 파라미터는 그대로 둡니다.

Q: OpenAI 공식 SDK를 그대로 사용해도 되나요? A: 가능합니다. 주요 언어의 OpenAI SDK는 모두 커스텀 baseURL을 지원하므로, http://183.240.79.21:52099/v1을 가리키도록 지정하면 됩니다.

Q: Claude / Gemini 등 OpenAI 외 모델은 어떻게 호출하나요? A: /v1/chat/completions로 통일해 호출하고 model만 해당 모델명으로 바꾸는 것을 권장합니다. 프로토콜 전환이 필요 없습니다. 반드시 Anthropic 네이티브 프로토콜을 사용해야 한다면 /v1/messages를 이용할 수 있습니다(함수 호출 / 멀티모달 미지원).

Q: 현재 키로 사용 가능한 모델은 어떻게 알 수 있나요? A: GET /v1/models를 호출하세요. 반환되는 목록이 현재 접근 권한이 있는 모델 전체입니다.

Q: 호출이 404를 반환하는데 어떻게 하나요? A: 먼저 경로가 단일 /v1인지 확인하세요(예: /v1/chat/completions, /v1/v1/...가 아님). 이어서 모델명 철자가 정확하고 GET /v1/models 반환 목록에 포함되어 있는지 확인하세요.

Q: 스트리밍 응답이 끝났는지는 어떻게 판단하나요? A: OpenAI 계열 엔드포인트의 SSE 스트림은 data: [DONE]을 종료 마커로 사용합니다. /v1/messages 엔드포인트는 Anthropic 형식의 SSE 이벤트 시퀀스를 반환합니다.

Q: 비디오 / 이미지 생성 작업은 얼마나 기다려야 하나요? A: 비동기 작업입니다. 제출 후 반환된 id로 상태가 완료로 바뀔 때까지 /v1/tasks/{id}를 폴링하세요.

Q: API 키 평문을 저장하지 못했습니다. 어떻게 하나요? A: 보안을 위해 평문은 생성 시 한 번만 표시되며 되찾을 수 없습니다. 콘솔에서 기존 키를 폐기하고 새로 생성하세요.

본 문서의 도메인 http://183.240.79.21:52099은 자리표시자 주소입니다. 정식 출시 후 실제 서비스 도메인으로 교체해 주세요. 로컬 개발 환경의 베이스 URL은 http://183.240.79.21:52099/v1입니다.