KO ▾

Chinese LLM API번역

API 키 받기

업데이트됨

OpenAI 호환 API URL: 베이스 URL 및 헤더

베이스 URL은 https://api.chinesellmapi.com/v1입니다. OpenAI 클라이언트가 베이스 URL을 기대하는 위치에 입력하고, 키를 Bearer 토큰으로 추가한 후 모델 ID uncensored를 사용하세요.

클라이언트를 API 엔드포인트에 연결하는 것을 나타내는 노트북 터미널과 빛나는 서버 큐브를 연결하는 케이블

짧은 답변

이 서비스에 대한 openai 호환 API URL을 찾고 있다면 다음 값을 복사하세요:

https://api.chinesellmapi.com/v1

이것이 베이스 URL입니다. "베이스 URL", "API 베이스", "엔드포인트" 또는 "호스트"라는 필드가 있는 모든 OpenAI SDK, 데스크톱 클라이언트 및 에이전트 프레임워크는 이 문자열을 사용합니다. 키는 일치하는 "API 키" 필드에 입력하고, 모델 이름은 uncensored입니다.

두 가지 엔드포인트가 있습니다: 채팅용 POST /v1/chat/completions 및 모델 목록 조회용 GET /v1/models. OpenAI API의 다른 기능은 제공되지 않으므로 임베딩 경로, 이미지 경로 및 파인튜닝 경로가 없습니다. 먼저 키가 필요한 경우 API 키 페이지에서 가입 절차를 안내합니다.

베이스 URL과 전체 엔드포인트 URL 비교

대부분의 실수가 여기서 발생합니다. 클라이언트는 베이스 URL을 입력하고 경로를 직접 추가하는 그룹과 호출의 전체 URL을 원하는 두 그룹으로 나뉩니다. 표는 두 가지 형태를 모두 보여줍니다.

필드가 요구하는 내용입력할 값
베이스 URL, API 베이스, OpenAI 호스트https://api.chinesellmapi.com/v1
전체 채팅 완성 URLhttps://api.chinesellmapi.com/v1/chat/completions
모델 목록 URLhttps://api.chinesellmapi.com/v1/models

공식 OpenAI SDK, LangChain의 OpenAI 래퍼, LiteLLM 및 대부분의 채팅 프론트엔드는 첫 번째 그룹에 속합니다. 원시 요청 URL을 붙여넣을 수 있는 도구는 두 번째 그룹에 속합니다. 필드 레이블이 어느 것인지 명시하지 않은 경우 플레이스홀더 텍스트를 읽으세요. /v1로 끝나는 것을 표시한다면 베이스 URL이 필요합니다.

후행 슬래시

대부분의 SDK는 후행 슬래시를 처리하지만, 일부는 단순 문자열 결합으로 최종 경로를 생성합니다. 404 오류가 발생하고 URL이 /v1/로 끝나는 경우 마지막 슬래시를 제거하고 다시 시도하세요.

API가 기대하는 헤더

요청에는 인증용 헤더와 본문 유형용 헤더가 하나씩 필요합니다:

  • Authorization: Bearer YOUR_KEY
  • Content-Type: application/json

SDK는 자동으로 설정해 줍니다. 요청을 직접 작성하는 경우, 가장 작은 성공적인 호출은 다음과 같습니다:

curl https://api.chinesellmapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in one sentence."}]
  }'

응답에는 몇 가지 유용한 헤더가 포함됩니다: 지원 문의용 X-Request-Id, 잔여 크레딧용 X-Balance-USD, 키에 적용되는 제한용 X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency

OpenAI SDK에서 설정하기

기본 OpenAI 설정과 비교하여 변경되는 값은 두 가지뿐입니다: 베이스 URL과 키. 코드에 있는 나머지는 그대로 유지됩니다.

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.chinesellmapi.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Translate 'good morning' into Chinese."}],
)
print(resp.choices[0].message.content)

Node

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.chinesellmapi.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Translate 'good morning' into Chinese." }],
});
console.log(resp.choices[0].message.content);

스트리밍도 동일하게 작동합니다: stream: true를 추가하고 청크를 읽으세요. 사용량 데이터는 스트림 끝에 도착합니다. 스트리밍 요청은 스트림이 닫힐 때까지 동시성 슬롯 중 하나를 점유한다는 점을 유의하세요.

코드 대신 환경 변수 사용

Python 및 Node용 현재 OpenAI SDK는 코드에서 전달하지 않을 때 OPENAI_BASE_URL 및 OPENAI_API_KEY을 환경 변수에서 읽습니다. 기존 프로젝트를 변경하지 않고 새 엔드포인트로 연결하는 가장 빠른 방법입니다:

export OPENAI_BASE_URL="https://api.chinesellmapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py

많은 서드파티 도구는 동일한 두 변수 이름을 사용하지만, 일부는 API_BASE 또는 OPENAI_API_BASE과 같은 자체 이름을 사용합니다. 정확한 이름은 도구 문서에서 확인하세요. 프로젝트에서 어딘가에 api.openai.com이 하드코딩되어 있다면 소스에서 해당 호스트명을 검색하여 교체하세요.

모델 이름은 보통 별도의 설정에 있으므로 uncensored로 변경하는 것도 기억하세요. 기본값으로 설정된 OpenAI 모델 이름이 그대로 남아 있는 것은 잘못된 URL 다음으로 오류가 발생하는 두 번째로 흔한 이유입니다.

앱 디버깅 전에 연결을 확인하세요

비용이 발생하지 않는 호출로 URL과 키를 테스트하세요. 모델 나열에는 토큰이 필요 없습니다:

curl https://api.chinesellmapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

이 호출이 uncensored를 포함하는 JSON 목록을 반환하면 URL과 키가 올바르며 나머지 문제는 클라이언트 설정에 있습니다. 실패하는 경우 이 표를 사용하세요.

증상잠재적 원인해결 방법
404 Not Found경로가 두 번 붙음 (/v1/v1/...) 또는 /v1 누락베이스 URL을 /v1로 끝나도록 정확히 한 번 입력하세요
401 Unauthorized키 누락, 공백 포함 복사 또는 잘못된 헤더 전송Authorization: Bearer YOUR_KEY를 전송하고 키를 다시 복사하세요
코드 rate_limited와 함께 429분당 요청 수 초과요청 속도를 줄이거나 큐에 추가하세요
코드 concurrency와 함께 429동시에 너무 많은 요청동시 호출을 제한하고 스트림이 슬롯을 점유한다는 점을 기억하세요
429 및 Retry-After: 5일시적 과부하5초를 기다린 후 다시 시도하세요
모델을 찾을 수 없음남아 있는 OpenAI 모델 이름모델을 uncensored로 설정하세요

프로덕션에 연결하기 전에 알아야 할 제한 사항

전체 키는 동시 요청 8개와 분당 요청 300개를 허용합니다. 체험 키는 동시 요청 2개와 분당 60개를 허용합니다. 요청 본문은 최대 8 MB까지 가능하며 컨텍스트 창은 프롬프트와 완성 합계 100,000 토큰이므로 max_tokens은 선택 사항입니다.

이 서비스는 텍스트 전용이며 독립적인 제공업체의 단일 오픈 웨이트 모델을 실행합니다. 어떤 모델 벤더의 공식 API가 아니며 벤더 간 라우팅도 수행하지 않습니다. 귀하의 앱이 중국어 제품인 경우 중국어로 된 앱 빠른 시작에서 프롬프트 구조를 구성하는 방법을 확인할 수 있으며, 번역 API 가이드에서는 용어집과 플레이스홀더를 다룹니다.

선불 크레딧에서 사용한 만큼 결제합니다: 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 실패하거나 거부된 요청에는 요금이 부과되지 않습니다. 가격 페이지에서 충전 금액과 보너스를 확인하세요. 새 사용자는 키 페이지에서 한 번의 클릭으로 7일 동안 유효하고 카드 등록 없이 사용 가능한 $0.50의 무료 체험 크레딧을 받을 수 있습니다. 클라이언트 설정에 대한 자세한 가이드가 필요하면 빠른 시작 문서을 참조하세요.

미성년자를 성적으로 묘사하는 콘텐츠는 절대 허용되지 않습니다. 그 외에는 합법적인 성인 이용을 위해 콘텐츠 거부 없이 답변하도록 모델이 조정되었습니다.

URL이 사용되는 다른 위치

프레임워크에서 필드 이름은 다르게 부르지만 값은 동일합니다. 일반적인 예시 세 가지:

# LangChain
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
    base_url="https://api.chinesellmapi.com/v1",
    api_key="YOUR_KEY",
    model="uncensored",
)

# LiteLLM
import litellm
r = litellm.completion(
    model="openai/uncensored",
    api_base="https://api.chinesellmapi.com/v1",
    api_key="YOUR_KEY",
    messages=[{"role": "user", "content": "ping"}],
)

LiteLLM에서 openai/ 접두사는 라이브러리가 자체 베이스 URL에 대해 OpenAI 호환 형식을 사용하도록 지시하며, 슬래시 뒤의 부분은 모델 ID입니다. SillyTavern과 같은 채팅 프론트엔드는 "사용자 지정 OpenAI 호환" 소스에 URL, 키, 모델 세 가지 입력란을 제공합니다. 동일한 세 가지 값입니다.

키는 브라우저에 남기지 마세요

방문자에게 배포되는 프론트엔드 JavaScript에서 API를 호출하지 마세요. 누구나 페이지에서 키를 읽고 크레딧을 사용할 수 있습니다. 중간에 작은 서버 라우트를 두고, 키를 그곳의 환경 변수에 저장한 후 사이트에서 해당 라우트를 호출하게 하세요.

코드 변경 없이 엔드포인트 전환

여러 제공업체를 테스트할 때 소스 코드가 아닌 설정 파일에 세 가지 값을 넣으세요. 간단한 설정 블록으로 충분하며, URL만 수정하면 됩니다:

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.getenv("LLM_BASE_URL", "https://api.chinesellmapi.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.getenv("LLM_MODEL", "uncensored")

이렇게 하면 스테이징과 프로덕션을 쉽게 분리할 수 있습니다. 환경별로 다른 키를 사용하고, X-Balance-USD 응답 헤더에서 각 키의 남은 크레딧을 확인할 수 있습니다.

질문과 답변

베이스 URL에 /chat/completions을 포함해야 하나요?

아니요. https://api.chinesellmapi.com/v1을 입력하면 SDK가 자동으로 /chat/completions을 붙입니다. 전체 요청 URL이 필요한 도구만 긴 형식을 사용합니다.

여러 앱에 동일한 URL을 사용할 수 있나요?

네. URL과 키는 여러 클라이언트에 사용할 수 있습니다. 이 키는 전체 키 기준 동시 요청 8개, 분당 요청 300개의 제한을 공유합니다.

어떤 모델 이름을 입력해야 하나요?

uncensored를 사용하세요. 키를 사용하여 GET /v1/models를 호출하여 확인할 수 있습니다.

이 OpenAI 스타일 벤더의 공식 API인가요?

아니요. 독립적인 제공업체가 운영하는 단일 오픈 웨이트 모델의 호스팅 API이며, OpenAI 요청 형식과 호환되도록 구축되었습니다.

크레딧을 쓰지 않고 키를 테스트하려면 어떻게 하나요?

Authorization 헤더와 함께 GET /v1/models를 호출하세요. 모델 목록을 반환하며 토큰을 사용하지 않습니다.

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

계정을 생성하고 키를 복사한 후 베이스 URL을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기