문제가 생겼을 때

FAQ 및 지원

#자주 묻는 질문

어떤 모델을 써야 하나요?

각 기능 페이지에서 추천하는 모델로 시작하세요. 현재 온라인 모델 중 가성비가 가장 좋습니다. 모델 및 요금에서 모든 모델의 실시간 가격을 볼 수 있으며, 요청의 필드 하나만 바꾸면 모델을 전환할 수 있습니다.

게이트웨이가 tool calling / function calling을 지원하나요?

네, 모든 OpenAI 형식 모델과 Claude, Gemini에서 지원합니다. 표준 tools 배열을 보내면 게이트웨이가 이를 전달하고 응답에 tool_calls를 반환합니다. 스트리밍 도구 호출 델타도 지원됩니다.

Cursor, Cherry Studio 등의 앱에서 사용할 수 있나요?

네. 시작하기의 “앱에서 사용하기”를 열고 앱을 고른 뒤 설정을 복사하세요 — 주소, 키, 모델 이름입니다. 코드는 필요 없습니다.

한도는 어떻게 차감되나요?

요청 시작 시 사전 차감되며(토큰 모델은 최대 추정치, 작업 모델은 표시 가격), 응답이 끝나면 제공업체가 보고한 실제 사용량에 맞춰 정산됩니다. 요청이 실패하면 사전 차감액은 자동으로 환불됩니다.

401이나 402가 나오면 어떻게 하나요?

401은 Bearer 토큰이 틀렸거나 키가 삭제 / 비활성화되었다는 뜻입니다. 402는 지갑 잔액이 사전 차감 추정액보다 부족하다는 뜻이니 — 충전 후 다시 시도하세요. 둘 다 모델의 버그가 아닙니다.

이미지 / 동영상 / 음악 생성도 같은 방식으로 쓸 수 있나요?

이미지 생성은 비동기 /v1/images/tasks 흐름을 사용합니다. 동영상은 POST /v1/videos, 음악은 POST /v1/music/generations를 사용합니다. 모든 비동기 작업 경로는 제출 → 폴링 → 결과(content) 흐름을 지원하며, 작업이 최종 상태에 도달하면 선택적으로 웹훅을 보낼 수 있습니다.

프롬프트가 기록되나요?

채팅 호출: 키에서 “요청 내용 기록”을 켜지 않는 한, 호출이 실패한 경우에만 요청과 응답의 축약본을 보관합니다(실패 원인 조사를 위해 15일). 이미지, 동영상, 음악 요청은 축약본을 15일간 보관합니다. 메타데이터(모델, 토큰, 비용, 시각, 요청 ID)는 30일간 보관합니다. 이 데이터는 운영팀만 볼 수 있습니다.

데이터는 얼마나 보관되나요?

결제 기록 — 모든 충전, 차감, 환불 — 은 영구 보관됩니다. 결제 페이지에는 최근 90일이 표시되며, CSV 내보내기로 전체를 다운로드할 수 있습니다. 사용량 페이지의 요청 기록과 이미지, 동영상, 음악 작업은 30일간 보관됩니다. 이후에도 일별 합계는 남지만, 30일이 지난 작업은 더 이상 조회할 수 없습니다.

프로젝트별로 키에 속도 제한이나 범위를 둘 수 있나요?

네. 키마다 RPM, RPD, 한도 상한, 모델 허용 목록, IP 허용 목록, 그룹을 따로 둘 수 있습니다. 코드를 건드리지 않고 콘솔 → API 키에서 무엇이든 바꿀 수 있습니다.

#지원

문제가 있거나 추가했으면 하는 모델이 있나요? 두 가지 방법으로 연락할 수 있습니다.

아직 해결되지 않았나요?

요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.