DeepSeek 사용자를 위한 Quickstart

Base URL 및 인증

API를 사용하려면 클라이언트를 https://api.deepseekapi.top/v1로 설정하세요. 엔드포인트 경로를 변경할 필요가 없으며, 표준 /v1/chat/completions이 예상대로 작동합니다. 인증은 가입 시 생성된 단일 API 키에 의존합니다. Authorization 헤더에 Bearer 토큰으로 이 키를 전달하세요. 키가 없거나 유효하지 않으면 서버는 401 오류를 반환합니다. 첫 번째 요청을 하기 전에 환경 변수가 올바르게 설정되었는지 확인하세요.

• 베이스 URL: https://api.deepseekapi.top/v1
• 인증 헤더: Authorization: Bearer YOUR_API_KEY

복사curl https://api.deepseekapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Chat Completions 엔드포인트

API는 표준 채팅 완성 요청을 받습니다. 모델 ID가 uncensored인 POST 요청을 /v1/chat/completions로 보내세요. 이 모델은 공식 DeepSeek나 기타 주요 제공업체에서 일반적으로 적용하는 콘텐츠 필터를 적용하지 않고 텍스트 입력에 응답하여 텍스트 출력을 생성합니다. 이는 창작 글쓰기, 역할극 또는 제한 없는 데이터 처리에 이상적입니다. temperature 및 top_p과 같은 매개변수를 사용하여 동작을 제어할 수 있습니다. 응답에는 생성된 텍스트와 토큰 사용 통계가 포함됩니다.

모델이 GPT, Claude 또는 기타 벤더의 모델이 아님을 기억하세요. 이는 독립적인 오픈 웨이트 모델로, 제한 없는 합법적 사용에 맞게 조정되었습니다. 토큰 비용은 가격 페이지를 확인하세요.

복사from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK 통합

Node.js 개발자의 경우 표준 OpenAI 통합과 프로세스가 동일합니다. 클라이언트를 특정 기본 URL과 API 키로 초기화하세요. 구성에서 모델을 uncensored로 설정하세요. SDK는 모든 OpenAI 호환 서비스와 마찬가지로 요청 수명 주기, 재시도 및 오류 처리를 처리합니다. 이를 통해 기존 코드베이스를 최소한의 마찰로 재사용할 수 있습니다. 전체 호환성을 위해 openai npm 패키지의 최신 버전을 사용하고 있는지 확인하세요.

API는 동기식 및 비동기식 호출을 모두 지원합니다. 표준 messages 배열 형식으로 메시지를 전달할 수 있습니다. 응답 구조는 OpenAI API 사양과 일치하므로 마이그레이션이 간단합니다.

복사import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

스트리밍 응답

요청에 stream: true를 설정하여 스트리밍을 활성화하세요. API는 Server-Sent Events (SSE) 스트림을 반환합니다. 각 청크에는 부분 응답이 포함되어 생성되는 텍스트를 즉시 표시할 수 있습니다. 토큰 사용 데이터는 스트림의 마지막 청크에만 포함되며 모든 청크에 포함되지 않습니다. 이 설계는 페이로드 크기를 줄이면서도 정확한 청구 지표를 제공합니다. 사용량 데이터를 얻기 위해 특별한 stream_options를 구성할 필요가 없습니다. 데이터는 자동으로 끝에 제공됩니다.

스트림 이벤트를 처리하여 UI를 실시간으로 업데이트하세요. 모델이 응답을 완료하거나 제한에 도달하면 스트림이 종료됩니다.

복사stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

함수 호출 및 JSON 모드

API는 tools 및 tool_choice 매개변수를 통해 함수 호출을 지원합니다. 요청에 함수를 정의하면 모델이 구조화된 도구 호출을 반환합니다. 또한 response_format을 {"type": "json_object"}로 설정하여 엄격한 JSON 출력을 강제할 수 있습니다. 이는 구문 분석 오류 없이 구조화된 데이터를 생성하는 데 유용합니다. 모델은 이러한 지시를 신뢰할 수 따르도록 조정되었습니다.

동적 상호 작용을 위해 함수 호출과 스트리밍을 결합하세요. API는 여러 턴에 걸쳐 컨텍스트를 유지하므로 복잡한 다단계 워크플로우를 허용합니다. 최상의 결과를 위해 함수 정의가 명확하고 구조화되어 있는지 확인하세요.

제한, 오류 및 컨텍스트 창

컨텍스트 창은 프롬프트와 완료를 합쳐 100,000 토큰입니다. 최대 출력은 요청당 32,000 토큰이며, max_tokens을 설정하지 않으면 2,048 토큰입니다. 속도 제한은 분당 300개 요청 및 키당 8개 동시 요청입니다. 이를 초과하면 429 오류가 발생합니다. 401 오류는 유효하지 않은 키를 나타내며, 402 오류는 선불 크레딧이 고갈되었음을 의미합니다. 오류와 거부는 토큰을 소모하지 않습니다. 요청은 8 MB 본문 크기로 제한됩니다. Google 또는 이메일로 가입하여 즉시 키를 받으세요.