ko ▾
今すぐ開始

빠른 시작: DeepSeek Coder API 통합

이 퀵스타트 가이드는 표준 OpenAI 호환 엔드포인트를 사용하여 기존 코드베이스에 당사 무검열 DeepSeek Coder API를 통합하는 방법을 안내합니다. 인증, 요청 전송, 모델 매개변수를 정밀하게 제어하며 스트리밍 응답을 처리하는 방법을 배웁니다.

Base URL 및 인증

API 키는 호스팅된 엔드포인트로의 모든 요청을 인증합니다. 기본 URL https://api.coderdeepseek.cc/v1 어떤 OpenAI SDK 또는 HTTP 클라이언트와 함께 사용하세요. 모델 식별자는 엄격히 uncensored. 이는 자체 서버에서 실행되며 타사 모델의 리셀이 아닙니다. Google 또는 이메일로 가입하면 즉시 API 키를 받게 됩니다. 이 키는 선불 크레딧을 관리하므로 안전하게 보관하세요.

인증은 다음에 기반합니다. Authorization 헤더. 키를 Bearer 토큰으로 전달하세요. 모든 요청에는 이 헤더를 포함해야 401 오류를 피할 수 있습니다. 401 인증에 쿼리 매개변수를 사용하지 않습니다. 이는 깔끔한 헤더와 표준 미들웨어와의 호환성을 보장합니다.

요청 전송: 채팅 완료

chat completions 엔드포인트는 프롬프트를 처리하고 텍스트 출력을 반환합니다. POST 요청을 다음 URL로 보내세요. /v1/chat/completions모델 이름, messages 배열, 그리고 원하는 매개변수를 포함하세요. 시스템은 텍스트를 입력받아 텍스트를 출력합니다. 응답 형식과 중지 기준을 제어할 수 있습니다. 이는 단순한 쿼리부터 복잡한 코딩 작업까지 모두 처리됩니다.

연결을 테스트하려면 다음 curl 명령어를 사용하세요. YOUR_API_KEY 실제 키를 사용합니다. 요청은 uncensored 모델 식별자입니다. 이는 인증 및 크레딧 잔액이 활성화되었음을 확인합니다.

curl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

응답에 choices 배열입니다. 각 선택에는 생성된 콘텐츠가 포함된 메시지가 포함되어 있습니다. 다음을 확인하십시오 usage 토큰 수를 위한 object입니다. 이를 통해 지출을 정확하게 모니터링할 수 있습니다.

Python SDK 통합

공식 OpenAI 패키지를 사용하여 Python 프로젝트에 API를 통합하세요. base URL을 엔드포인트로 설정하세요. API 키로 클라이언트를 초기화하세요. 이렇게 하면 익숙한 메서드들을 사용할 수 있습니다. chat.completions.create. SDK는 JSON 직렬화 및 HTTP 요청을 자동으로 처리합니다.

모델을 다음으로 구성하세요 uncensored. 표준 형식으로 메시지를 전달하세요. SDK는 함수 호출 및 JSON 모드와 같은 모든 기능을 지원합니다. temperature 및 top_p와 같은 매개변수를 직접 설정할 수 있습니다. 이렇게 하면 다른 제공업체로의 마이그레이션이 쉬워집니다.

from openai import OpenAI

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

네트워크 오류나 잘못된 요청에 대한 예외를 처리하세요. 원본 응답을 파싱하는 경우 상태 코드를 확인하세요. 이는 애플리케이션에서 견고한 오류 처리를 보장합니다. SDK는 대부분의 복잡성을 추상화합니다.

Node SDK 통합

JavaScript 또는 TypeScript 프로젝트와 연동하려면 Node.js OpenAI SDK를 사용하세요. 패키지를 설치하고 base URL을 구성하세요. 이는 기존 코드 구조와의 호환성을 유지합니다. Python과 동일한 메서드를 사용할 수 있습니다. SDK는 CommonJS와 ES 모듈을 모두 지원합니다.

모델을 다음으로 설정하세요 uncensored. 메시지와 매개변수를 전달하세요. SDK는 스트리밍 및 비스트리밍 요청을 모두 처리합니다. 오류를 포착하고 적절히 로깅할 수 있습니다. 이렇게 하면 부하가 걸려도 애플리케이션이 안정적으로 유지됩니다.

import OpenAI from "openai";

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

간단한 프롬프트로 통합을 테스트하세요. 응답이 기대와 일치하는지 확인하세요. 응답 객체의 토큰 사용량을 확인하세요. 이는 비용과 성능을 추적하는 데 도움이 됩니다. SDK는 빠른 반복을 쉽게 만들어 줍니다.

스트리밍 응답 및 토큰 사용량

stream을 true로 설정하여 스트리밍 활성화 stream: true 요청에 포함됩니다. API는 서버 전송 이벤트(SSE) 스트림을 반환합니다. 텍스트는 생성되는 대로 청크 단위로 제공됩니다. 이는 긴 응답의 지각된 지연 시간을 줄여줍니다. 마지막 청크에는 총 토큰 사용량이 포함됩니다.

SSE 이벤트를 파싱하여 내용을 추출하세요. 청크를 연결하여 완전한 응답을 구성하세요. 모니터링 usage 마지막 청크의 object입니다. 이는 청구를 위한 정확한 토큰 수를 제공합니다. 스트리밍은 실시간 애플리케이션에 이상적입니다.

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)

네트워크 중단 사항을 우아하게 처리하세요. 스트림이 끊기면 다시 연결하세요. API는 이전 청크를 다시 보내지 않습니다. 클라이언트 측에서 전체 텍스트를 재구성해야 합니다. 이는 원활한 사용자 경험을 제공합니다.

제한 사항, 오류 및 컨텍스트 윈도우

API는 안정성을 위해 엄격한 제한을 적용합니다. 키당 분당 300회 요청이 가능합니다. 최대 8개의 요청이 동시에 실행될 수 있습니다. 요청 본문은 8MB를 초과할 수 없습니다. 이러한 제한을 초과하면 429 rate limit 오류. 지수 백오프로 이러한 오류를 처리하세요.

컨텍스트 윈도우는 100,000 토큰입니다. 여기에는 프롬프트와 completion이 모두 포함됩니다. 요청당 최대 출력은 16,000 토큰입니다. max_tokens을 설정하지 않으면 max_tokens, 기본값은 2,048입니다. A 401 키가 유효하지 않음을 의미합니다. A 402 크레딧이 없음. 서비스를 계속 사용하려면 암호화폐를 통해 충전하십시오.

자주 묻는 질문

DeepSeek Coder API의 베이스 URL은 무엇인가요?

기본 URL은 HTTPS://api.coderdeepseek.cc/v1입니다. 이는 모든 OpenAI 호환 클라이언트에서 작동합니다. 모델을 uncensored로 설정해야 합니다.

속도 제한을 어떻게 처리하나요?

분당 300회 요청으로 제한됩니다. 이를 초과하면 429 오류가 발생합니다. 요청 재시도를 위해 지수 백오프를 구현하세요.

크레딧이 부족해지면 어떻게 되나요?

402 오류가 발생합니다. API 키는 유효합니다. USDT 또는 USDC로 충전하여 접근 권한을 복원하세요. 잔액은 만료되지 않습니다.

API 키는 단 한 단계만 더 남았습니다.

가입하고, 키를 가져온 후, 베이스 URL을 업데이트하세요. 전체 설정이 이것뿐입니다.

今すぐ開始