DeepSeek V4 API: 5분 내 첫 요청

인증 및 기본 URL

당사 API는 표준 API 키 인증을 사용합니다. 이메일과 비밀번호를 입력하여 API 키 받기 페이지에서 키를 즉시 생성할 수 있습니다. 체험용에는 신용카드가 필요 없으며, 7일 동안 유효한 $0.50 크레딧이 제공됩니다. 키를 얻은 후 클라이언트를 다음 기본 URL로 구성하세요: https://api.deepseek4api.com/v1.

Authorization 헤더를 Bearer YOUR_API_KEY로 설정하세요. 이 기본 URL은 모든 OpenAI 호환 SDK와 함께 작동합니다. 요청에 지정해야 하는 모델 식별자는 uncensored입니다. 이는 벤더별 변형 모델이 아닌 제한 없는 응답에 최적화된 당사 오픈 웨이트 모델과 상호 작용함을 보장합니다.

기본 채팅 완료

텍스트를 생성하려면 표준 채팅 완료 요청을 보내세요. API는 role 및 content 필드가 포함된 메시지 목록을 받습니다. 아래는 간단한 텍스트 쿼리를 보여주는 기본 cURL 예제입니다. 기본 URL과 모델 ID를 조정하면 모든 OpenAI 호환 클라이언트에서 작동합니다.

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

YOUR_API_KEY을 생성한 키로 바꾸세요. 응답에는 생성된 텍스트가 포함된 표준 choices 배열이 포함됩니다. 이 엔드포인트는 도구/함수 호출을 지원하므로 애플리케이션에 구조화된 출력을 통합할 수 있습니다.

Python SDK 통합

공식 OpenAI Python SDK를 사용하여 당사 API와 상호 작용하세요. 클라이언트를 당사 기본 URL과 API 키로 구성하세요. 모델 이름은 uncensored입니다. 이 방법은 백엔드 모델만 변경하면서 기존 클라이언트 코드를 유지할 수 있게 해줍니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseek4api.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)

openai 패키지가 설치되어 있는지 확인하세요. 위의 코드는 동기식 요청을 보여줍니다. 비동기 애플리케이션의 경우 동일한 구성으로 AsyncOpenAI 클라이언트를 사용할 수 있습니다. 이 방법은 신뢰할 수 있는 비스트리밍 텍스트 생성이 필요한 백엔드 서비스에 이상적입니다.

Node SDK 사용법

Node.js 애플리케이션의 경우 openai npm 패키지를 사용하세요. baseURL을 당사 서비스로 설정하고 API 키를 제공하여 클라이언트를 초기화하세요. 모델 식별자는 여전히 uncensored입니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseek4api.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);

이 설정을 통해 JavaScript 또는 TypeScript 프로젝트에 무검열 LLM 기능을 통합할 수 있습니다. SDK는 JSON 직렬화 및 HTTP 요청을 자동으로 처리합니다. 애플리케이션에서 구조화된 데이터 출력이 필요한 경우 도구나 함수 호출을 추가하여 이 기본 설정을 확장할 수 있습니다.

스트리밍 응답

실시간 텍스트 생성을 위해 클라이언트에서 스트리밍을 활성화하세요. 요청 매개변수에 stream: true을 설정하세요. API는 생성되는 토큰을 처리할 수 있는 서버 전송 이벤트(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)

코드에서 스트림 이벤트를 처리하여 텍스트를 단계별로 표시하세요. 스트리밍은 Python 및 Node SDK 모두에서 작동합니다. 응답이 완료되거나 오류가 발생하면 클라이언트가 스트림 연결을 적절히 닫도록 하세요. 이는 즉각적인 피드백이 중요한 채팅 인터페이스에 필수적입니다.

한도, 오류 및 컨텍스트

API는 프롬프트와 완료의 합계에 대해 100,000 토큰 컨텍스트 창을 적용합니다. 요청 본문은 8 MB를 초과할 수 없습니다. API 키당 1분당 300개 요청으로 제한됩니다. 이 한도를 초과하면 429 속도 제한 오류가 발생합니다.

인증 오류는 키가 유효하지 않을 경우 401을 반환합니다. 청구 오류는 선불 크레딧이 고갈된 경우 402을 반환합니다. 구독과 달리 당사의 선불 크레딧은 만료되지 않습니다. 대시보드에서 언제든지 키를 재생성하면 이전 키가 즉시 무효화됩니다. 이를 통해 다운타임 없이 보안 액세스 관리를 보장합니다.