DeepSeek 사용자를 위한 Quickstart

인증 및 베이스 URL

API는 https://api.deepseekapikey.com/v1에서 호스팅됩니다. 인증을 위해 Authorization 헤더에 Bearer 토큰으로 API 키를 포함하세요. 이메일과 비밀번호만으로 API 키 받기 페이지에서 키를 생성할 수 있습니다. 키를 분실하면 언제든지 재생성할 수 있으며, 이전 키는 즉시 무효화됩니다. 일부 벤더와 달리 초기 체험 계정에는 신용카드가 필요하지 않습니다.

첫 번째 요청

표준 POST 요청을 /v1/chat/completions로 전송하세요. 오픈 웨이트 모델에 접근하려면 모델 ID uncensored를 사용하세요. 요청 본문은 프롬프트를 포함하는 messages 배열을 가진 표준 구조를 따릅니다. 이 엔드포인트는 텍스트 입력과 출력을 지원하므로 기존 통합의 대체재로 사용할 수 있습니다.

Copycurl https://api.deepseekapikey.com/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."}]
  }'

Python SDK 통합

공식 OpenAI Python 클라이언트를 사용 중이라면 base_url 매개변수를 재정의하여 베이스 URL을 설정할 수 있습니다. 키를 클라이언트 초기화 시 전달하세요. 이 방식은 기존 Python 코드 구조를 유지하면서 요청을 무검열 엔드포인트로 라우팅할 수 있게 합니다. 클라이언트는 JSON 직렬화와 응답 파싱을 자동으로 처리합니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapikey.com/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.js SDK 통합

Node.js 애플리케이션의 경우 동일한 구성 전략으로 OpenAI 클라이언트를 초기화하세요. baseURL을 API 엔드포인트로 설정하고 키를 제공하세요. 이렇게 하면 툴 사용 포함 모든 후속 호출이 당사 서버로 올바르게 라우팅됩니다. 이 방법은 baseURL 재지정을 존중하는 모든 호환 SDK와 함께 작동합니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapikey.com/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는 서버에서 생성된 이벤트(SSE) 스트림을 반환하여 토큰이 생성되는 대로 수신할 수 있습니다. 이는 실시간 피드백이 필요한 사용자 인터페이스에 이상적입니다. 스트림 형식은 표준 OpenAI SSE 사양과 일치하므로 기존 스트리밍 핸들러는 수정 없이 작동해야 합니다.

Copystream = 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)

제한, 오류 및 컨텍스트

컨텍스트 창은 프롬프트와 완료 합계 기준 100,000개의 토큰을 지원합니다. 분당 300회의 속도 제한을 초과하면 API는 429 오류를 반환합니다. 인증 실패는 401 상태를 반환하며, 선불 크레딧 부족은 402 오류를 반환합니다. GET /v1/models을 통해 사용 가능한 모델을 확인할 수 있지만, 주요 엔드포인트는 채팅 완료용으로 설계되었습니다. 프롬프트는 학습에 사용되지 않으며, 모델은 미성년자 관련 성 콘텐츠는 차단합니다.