개발자를 위한 API 문서

Base URL 및 인증

베이스 URL을 전용 엔드포인트로 변경하고 Authorization 헤더에 API 키를 전달하세요. 표준 OpenAI 베이스 URL을 사용하지 않으므로 SDK를 https://api.deepseektokenplan.com/v1. 이를 통해 요청이 타사 프록시가 아닌 당사의 무검열 모델 인프라로 라우팅되도록 보장합니다. 요청 본문에 지정한 모델 ID는 "uncensored"이며, 이는 서버의 특정 미세 조정 가중치를 트리거합니다. 인증은 모든 OpenAI 호환 클라이언트 라이브러리에서 작동하는 간단한 Bearer 토큰 방식을 기반으로 합니다. 키는 Google 또는 이메일을 통해 가입하는 즉시 생성되며 전화번호가 필요하지 않습니다. 이 키는 직접적으로 사전 결제된 잔액에 연결되므로 안전하게 보관하세요.

첫 번째 요청

cURL을 사용하여 표준 채팅 완료 요청을 보내 설정 및 모델 가용성을 확인하세요. 이 간단한 POST 요청은 API가 시스템 프롬프트와 사용자 메시지를 어떻게 허용하는지 보여줍니다. 창의성을 제어하기 위해 temperature 및 top_p 매개변수를 조정할 수 있습니다. 응답에는 생성된 텍스트와 함께 청구 투명성을 위한 토큰 사용량 통계가 반환됩니다. 요청 본문에 올바른 모델 식별자와 헤더의 API 키가 포함되어 있는지 확인하세요. 이 방법은 텍스트 생성과 함수 호출 시나리오 모두에서 작동합니다. 애플리케이션에 통합하기 전에 연결성을 확인하려면 이 명령어를 사용하세요. 엔드포인트는 스트리밍 및 비스트리밍 모드 모두를 잘 지원합니다.

Python SDK 통합

기본 URL과 API 키를 구성하여 우리 API와 상호작용하세요. 자격 증명으로 클라이언트를 초기화하고 원하는 모델 ID로 채팅 completion 메서드를 호출하세요. 이 방법은 대규모 리팩토링 없이 OpenAI용으로 구축된 기존 코드베이스를 활용할 수 있게 해줍니다. 응답을 스트리밍하거나 전체 텍스트를 한 번에 받을 수 있습니다. 라이브러리가 JSON 직렬화 및 HTTP 요청을 자동으로 처리합니다. 특정 사용 사례에 맞게 시간 제한 및 재시도 설정을 구성하세요. 이 방법은 백엔드 서비스 및 데이터 처리 파이프라인에 이상적입니다. 기본 URL을 우리 특정 엔드포인트로 업데이트하세요.

Node SDK 통합

OpenAI Node 패키지를 사용하여 JavaScript 또는 TypeScript 애플리케이션에 API를 통합하세요. 요청을 하기 전에 클라이언트 구성에 Base URL과 API 키를 설정하세요. 이 설정은 다음 같은 익숙한 메서드를 사용할 수 있게 합니다. chat.completions.create() 우리의 비제약 모델과 함께 사용합니다. 온도나 중지 시퀀스와 같은 매개변수를 전달하여 출력을 미세 조정할 수 있습니다. SDK는 실시간 애플리케이션을 위해 스트리밍 응답을 효율적으로 처리합니다. 웹 서버나 명령줄 도구에 이 방법을 사용하세요. 필요한 모듈을 가져오고 환경 변수를 올바르게 구성했는지 확인하세요. 이 방법은 동기식 및 비동기식 요청 패턴을 모두 지원합니다.

스트리밍 및 토큰

채팅 인터페이스의 사용자 경험을 개선하기 위해 생성되는 대로 부분 응답을 받도록 스트리밍을 활성화하세요. API는 실시간으로 토큰을 전달하기 위해 서버 전송 이벤트(SSE)를 사용합니다. 스트림의 마지막 청크에서 토큰 사용량을 추적하여 정확한 과금을 수행할 수 있습니다. 이 기능은 모든 주요 SDK에서 지원되며 필요시 수동으로 구현할 수 있습니다. 스트리밍은 긴 응답의 인지된 지연 시간을 줄여줍니다. 설정 stream 요청 본문에서 true로 설정하세요. API는 마지막 이벤트에서 사용 통계를 반환하여 선불 크레딧에서 올바른 금액을 차감할 수 있게 합니다. 이 방법은 즉각적인 피드백이 필요한 애플리케이션에 필수적입니다.

제한 사항 및 오류 처리

안정적인 연결을 보장하기 위해 속도 제한을 모니터링하고 오류를 적절히 처리하세요. API는 키당 분당 300회 요청 및 8개의 동시 요청을 허용합니다. 각 요청 본문은 8MB를 초과해서는 안 됩니다. 유효하지 않은 키를 보내면 401 Unauthorized 오류가 발생합니다. 402 오류는 부족 선불 크레딧을 나타내며, 암호화폐로 충전해야 합니다. 429 오류는 속도 제한을 초과했음을 의미합니다. 기다렸다가 다시 시도하세요. 컨텍스트 윈도우는 프롬프트 및 완료를 합쳐 100,000 토큰입니다. 최대 출력은 16,000 토큰이며, 더 낮은 값을 지정하지 않는 한 max_tokens 값입니다. 항상 상태 코드와 응답 본문을 확인하여 자세한 오류 메시지를 확인하세요.

cURL

Copycurl https://api.deepseektokenplan.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total monthly cost for 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

스트리밍

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)