자주 묻는 질문
과금은 어떻게 이루어지나요?
사용한 만큼 선불 크레딧에서 차감합니다. 모든 응답의 usage 필드에 프롬프트 토큰 수와 출력 토큰 수가 담기며, 모델별 100만 토큰당 단가로 계산한 금액을 크레딧에서 차감합니다. 잔액과 사용 내역은 콘솔의 크레딧 페이지에서 확인하세요.
무료 체험이나 체험 크레딧이 있나요?
신규 계정에는 API를 시험해 볼 수 있는 체험 크레딧을 지급합니다. 이메일 인증을 마치면 한 번 지급하며, 지급 후 30일이 지나면 만료됩니다. 금액은 로그인 후 콘솔의 크레딧 페이지에 표시됩니다.
어떤 모델을 사용할 수 있나요?
지금 Kiln이 제공하는 모델과 각 모델의 컨텍스트 길이·단가·지원 기능은 모델 페이지에 있고, 호출할 수 있는 ID는 GET /v1/models로 조회합니다. 이 문서의 예제는 qwen3-32b를 사용합니다. 지원 모델은 계속 늘려 갈 예정입니다.
정말 OpenAI 호환인가요?
네. 공식 OpenAI SDK(Python, JavaScript)나 OpenAI 호환 클라이언트를 그대로 쓸 수 있습니다. base_url과 API 키만 바꾸면 되며, 요청·응답 형식, 스트리밍, usage 필드가 모두 같습니다. 툴 호출은 gpt-oss-120b에서 자동 툴 선택만 동작합니다(강제·병렬 호출 불가). 다른 모델은 동작이 다르므로 모델 페이지를 참고하세요. 일부 파라미터(response_format, stop)는 아직 지원하지 않습니다. OpenAI에서 옮겨오기 페이지의 알려진 제한을 참고하세요.
기존 OpenAI 코드를 얼마나 수정해야 하나요?
OpenAI SDK를 사용하고 있다면 base_url과 API 키를 변경하는 것만으로 시작할 수 있습니다. 요청·응답 형식은 그대로이므로 나머지 코드는 손대지 않아도 됩니다.
응답을 스트리밍하려면 어떻게 하나요?
stream: true로 설정하세요. 토큰이 SSE(server-sent events)로 도착하며 OpenAI SDK가 자동으로 파싱합니다. 스트림이 끝날 때 토큰 사용량도 받으려면 stream_options.include_usage를 true로 설정하세요.
구조화된 JSON 출력을 받을 수 있나요?
response_format(json_object, json_schema)은 아직 지원하지 않습니다. 지금은 이 옵션을 넣은 요청의 content가 비어 반환됩니다. 대신 프롬프트에서 JSON으로만 답하도록 지시하고, 클라이언트에서 결과를 파싱해 검증하세요.
모델의 추론(reasoning) 양을 조절할 수 있나요?
네. reasoning_effort는 모델에 그대로 전달되며, gpt-oss-120b는 low, medium, high를 받습니다. 다른 모델이 이 값을 따르는지는 공개되지 않았습니다. low는 가장 빠르게 답하고, high는 어려운 문제에 reasoning 토큰을 더 많이 씁니다. reasoning 토큰은 출력 토큰으로 과금됩니다.
제 데이터는 어떻게 사용되나요?
프롬프트와 출력은 요청을 처리하고 과금용 사용량을 측정하는 데 사용합니다. 기본적으로 학습에는 사용하지 않습니다. 데이터 처리 계약이 필요하면 문의하세요.
크레딧이 소진되면 어떻게 되나요?
충전할 때까지 요청이 402 Payment Required로 차단됩니다. 콘솔의 크레딧 페이지에서 크레딧을 충전하세요.
레이트 리밋과 에러는 어떻게 처리하나요?
429와 5xx 응답은 지수 백오프로 재시도하세요. 분당 요청 또는 분당 토큰 429에는 x-ratelimit-reset이 실리므로 그 초만큼 기다리세요. 동시성 429에는 레이트 리밋 헤더가 없으므로 백오프하세요. 자세한 내용은 레이트 리밋 페이지와 에러 페이지를 참고하세요.