KO ▾

Chinese LLM API무료 체험 FAQ

API 키 받기

업데이트됨

Chinese LLM API 무료 체험: 작동 방식과 자주 묻는 질문

새 계정에서는 크레딧을 충전하기 전에 API를 사용해 볼 수 있습니다. 이 페이지는 가장 자주 묻는 질문에 답합니다: 무료 체험 크레딧의 범위, $0.50으로 얼마나 사용할 수 있는지, 키의 동작 방식, 예상되는 제한 및 오류, 허용되는 콘텐츠 등. 답변은 주제별로 그룹화되어 필요에 따라 바로 확인할 수 있습니다.

체험에 대하여

무료로 무엇을 받을 수 있나요?

모든 새 계정에는 $0.50의 크레딧이 제공됩니다. 가입일로부터 7일 동안 유효하며, 크레딧을 받기 위해 결제 정보를 입력할 필요가 없습니다. 크레딧은 유료 계정이 사용하는 동일한 엔드포인트와 동일한 모델에 적용되므로, 테스트하는 내용이 곧 프로덕션에서 실행할 내용과 동일합니다.

$0.50으로 얼마나 사용할 수 있나요?

프롬프트에 따라 다르므로 가정 사항을 명시한 예시를 들어보겠습니다. 각 요청이 1,000개의 입력 토큰을 보내고 500개의 출력 토큰을 받는다고 가정합니다. 입력 토큰 백만 개당 $0.25, 출력 토큰 백만 개당 $1.00의 가격으로 하나의 요청 비용은 $0.00025 + $0.0005 = $0.00075입니다. 따라서 $0.50로는 약 660개의 요청을 처리할 수 있습니다. 짧은 대화는 더 오래 지속되고 긴 컨텍스트 호출은 크레딧을 더 빠르게 소모합니다.

체험이 종료되면 어떻게 되나요?

7일이 지나거나 크레딧이 먼저 소진되면 요청 시 HTTP 402와 코드 no_credit이 반환됩니다. 삭제된 데이터는 없습니다. 선불 잔액을 충전하면 동일한 키가 다시 작동합니다. 구독은 없으며 충전된 잔액은 만료되지 않습니다.

시작하려면 결제 정보를 추가해야 하나요?

아니요. 등록은 이메일과 비밀번호만으로 가능합니다. 키는 키 받기 페이지에서 가입 직후 바로 표시됩니다.

7일간의 실용적인 계획

미리 배우고 싶은 내용을 결정한다면 7일은 충분합니다. 체험을 어드혹 테스트가 아닌 작은 평가 프로젝트로 생각하세요. 대부분의 팀에 잘 작동하는 순서는 다음과 같습니다:

  1. 1일차: 연소 테스트. 키, 모델 목록 및 짧은 완성을 확인합니다. 아래 명령어는 이 세 가지를 모두 수행합니다.
  2. 2~3일차: 실제 프롬프트. 자체 제품의 대표 입력 20~50개를 API로 실행합니다. 동료들이 재실행 없이 검토할 수 있도록 입력 옆에 출력을 저장하세요.
  3. 4일차: 실패 경로. 의도적으로 오버사이즈 요청으로 400 오류를 발생시키고, 잘못된 키로 401 오류를 발생시킨 후 429 및 503 처리를 작은 버스트로 테스트합니다. 이러한 오류를 운영 환경에서 보기 전에 미리 확인하는 것이 좋습니다.
  4. 5~6일차: 비용 모델. 기록된 토큰 수에 공개된 요금을 곱하여 자체 트래픽 가정 하에 월별 금액을 산출합니다.
  5. 7일차: 결정. 품질, 비용 및 제한 사항을 요구 사항과 비교한 후 충전 여부를 결정합니다.
export API_KEY="paste-your-key-here"

# 1) confirm the key works and see the model id
curl -s https://api.chinesellmapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

# 2) one short completion; read the usage block in the reply
curl -s https://api.chinesellmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"用一句话介绍杭州的春天。"}],"max_tokens":120}'

두 번째 호출은 프롬프트 및 완료 토큰 수를 포함하는 사용량 객체를 반환합니다. 첫날부터 이러한 데이터를 로깅하세요. 이는 나중에 모든 비용 추정의 원자재가 됩니다.

키 및 시작하기

키를 몇 개나 가질 수 있나요?

계정당 하나입니다. 새 키가 필요하면 계정에서 재생성하세요. 이전 키는 즉시 사용 중지되므로, 이전 값을 여전히 사용하는 모든 서비스에서 401 오류가 발생하지 않도록 배포를 즉시 업데이트하세요.

키는 어디에 넣어야 하나요?

서버의 환경 변수(예: API_KEY)에 넣고 브라우저 코드나 공개 저장소에는 넣지 마세요. 요청은 Authorization: Bearer <key> 형식으로 키를 전달합니다.

작동이 확인되는 가장 작은 요청은 무엇인가요?

GET /v1/models로 모델을 나열한 다음, 모델 uncensored과 낮은 max_tokens을 사용하여 /v1/chat/completions로 짧은 채팅 완성을 보냅니다. 응답의 usage 필드는 호출의 토큰 비용을 정확히 보여줍니다.

OpenAI SDK를 사용할 수 있나요?

네. 이 API는 OpenAI 채팅 완성 API와 호환됩니다. 기본 URL을 https://api.chinesellmapi.com/v1로 설정하고 API 키를 제공한 후, 모델을 uncensored로 지정하세요. 프롬프트 및 스크립트 제어 방법을 포함한 전체 가이드는 quickstart에서 확인하세요.

제한 사항 및 기능

프롬프트와 응답의 길이는 얼마나 될 수 있나요?

컨텍스트 창은 프롬프트와 완성을 합쳐 100,000토큰입니다. max_tokens 설정은 기본값이 2,048이며 요청당 최대 32,000까지 높일 수 있습니다. 요청 본문은 최대 8 MB까지 가능합니다. 프롬프트 + max_tokens이 창을 초과하면 API가 400을 반환합니다.

얼마나 많은 요청을 보낼 수 있나요?

각 키는 분당 300개의 요청으로 제한됩니다. 이를 초과하면 429 오류가 발생합니다. 배치 작업을 고르게 분산하고 백오프를 추가하세요. 번역 가이드에는 속도 조절된 배치 스크립트가 포함되어 있습니다.

스트리밍과 함수 호출을 지원하나요?

두 가지 모두 지원합니다. 서버 전송 이벤트를 위해 stream: true를 설정하고, 사용량 정보가 포함된 마지막 청크를 받습니다. 도구는 OpenAI 형식으로 허용되며, temperature, top_p 및 stop과 같은 샘플링 필드는 전달됩니다.

사용할 수 없는 기능은 무엇인가요?

텍스트만 제공됩니다: 임베딩, 이미지, 오디오, 비디오 또는 파인튜닝은 없습니다. 단일 모델만 있습니다. 프로젝트에 누락된 기능이 필요한 경우 해당 부분에 대해 다른 도구와 함께 이 API를 사용하도록 계획하세요.

발생할 수 있는 오류

어떤 상태 코드를 예상해야 하나요?

오류는 {"error":{"code":...,"message":...}} 형태의 JSON으로 반환됩니다. 400은 잘못된 요청, 401은 유효하지 않거나 누락된 키, 402는 no_credit, 403은 content_blocked, 404는 알 수 없는 엔드포인트, 429는 속도 제한, 503은 upstream_busy을 의미합니다.

어떤 오류를 재시도할 가치가 있나요?

429와 503만 재시도하세요. 기다리고 랜덤 지터(jitter)를 추가한 후 제한된 횟수만큼 재시도하세요. 503의 경우 몇 초면 충분합니다. 400, 401, 402 또는 403을 재시도해도 결과가 바뀌지 않습니다.

충전했는데도 402 오류가 계속 표시됩니다. 어떻게 해야 하나요?

키를 재생성하면 이전 키가 대체되므로 현재 키를 사용하고 있는지 확인하세요. 그런 다음 요청이 올바른 base URL로 전송되는지 확인하세요. 모든 것이 일치하면 최소한의 요청을 보내고 응답 본문의 오류 메시지를 읽어보세요.

무료 체험 크레딧을 오래 쓰는 방법

크레딧은 의도적으로 적게 제공되므로 몇 가지 습관으로 더 오래 사용할 수 있습니다. 테스트 중에는 max_tokens을 낮게 유지하세요. 출력 토큰은 입력 토큰보다 네 배 비싸기 때문입니다: 백만 토큰당 $1.00 vs $0.25. 먼저 짧고 대표적인 프롬프트로 테스트한 후, 짧은 프롬프트가 잘 작동할 때만 가장 긴 입력으로 넘어가세요. 정지 조건 없이 API를 호출하는 루프를 피하고, 자체 코드에서 재시도 횟수를 제한하세요.

가정 하에 계산한 예시: 50개의 프롬프트로 구성된 평가 세트, 각 프롬프트는 입력 토큰 약 600개, 응답은 출력 토큰 300개로 제한됩니다. 한 번 실행에는 입력 토큰 30,000개와 출력 토큰 15,000개가 필요하며, 이는 $0.0075 + $0.015 = $0.0225가 듭니다. 이 전체 세트를 크레딧이 다 떨어지기 전에 약 22번 실행할 수 있으며, 이는 여러 프롬프트 변형을 충분히 비교하기에 충분합니다.

매우 긴 프롬프트를 전달할 때는 전체 프롬프트가 모든 호출에서 청구된다는 점을 기억하세요. 40,000 토큰 문서를 20번 전송하는 것은 20개의 별도 큰 요청과 비용이 동일하므로, 가능한 경우 공유 컨텍스트를 캐시하거나 요약하세요. 현재 요금은 요금 페이지에 나열되어 있으며, 파라미터 세부 사항은 문서에서 확인할 수 있습니다.

콘텐츠 규칙 및 개인정보 보호

어떤 콘텐츠가 허용됩니까?

합법적인 성인 콘텐츠, 소설 및 논쟁적인 주제는 일반적으로 거부되지 않습니다. 이 서비스는 18세 이상의 성인을 위한 것입니다. 장편 소설 및 캐릭터 채팅의 경우, 소설 가이드에서 프롬프트 구조와 비용에 대해 다루고 있습니다.

항상 차단되는 것은 무엇입니까?

미성년자가 포함된 성적 콘텐츠는 소설 및 역할극을 포함하여 모든 경우 차단되며 403 오류를 반환합니다. 이 차단은 프롬프트 문구로 변경할 수 없으므로 재시도하지 마세요.

내 프롬프트는 학습에 사용됩니까?

아니요, 프롬프트는 학습에 사용되지 않습니다.

질문과 답변

새로운 계정에는 얼마나 많은 무료 크레딧이 제공됩니까?

새로운 계정에는 7일 동안 유효한 $0.50의 무료 체험 크레딧이 제공되며, 결제 정보 없이 등록할 수 있습니다.

시작하기 위해 카드가 필요합니까?

결제 정보가 필요하지 않습니다. 이메일과 비밀번호로 등록하면 키가 즉시 표시됩니다.

무료 체험 크레딧이 다 떨어지면 어떻게 됩니까?

요청 시 no_credit 오류(402)가 반환됩니다. 선불 잔액을 충전하면 동일한 키가 계속 작동하며 구독은 없습니다.

여러 개의 키를 가질 수 있습니까?

각 계정에는 하나의 키가 있습니다. 키를 재생성할 수 있지만 이전 키는 즉시 작동하지 않게 됩니다.

무료 체험 기간 중 어떤 제한이 적용됩니까?

유료 사용과 동일합니다: 100,000 토큰 컨텍스트 창, max_tokens 최대 32,000, 요청 본문 최대 8 MB, 키당 분당 300 요청.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 이것이 전체 설정입니다.

API 키 받기