Dolphin 무차별 API 문서

필수 조건 및 환경 설정

요청을 보내기 전에 환경에 필요한 종속성이 설치되어 있는지 확인하세요. 대시보드에서 활성화된 API 키와 Python이나 Node.js와 같은 지원되는 런타임이 필요합니다. 우리 API는 기본 OpenAI 엔드포인트가 아닌 특정 기본 URL로 요청을 보내야 합니다.

API 키를 안전하게 보관하고 환경 변수에 저장하세요. 이렇게 하면 코드 저장소에서 실수로 노출되는 것을 방지할 수 있습니다. Google 또는 이메일로 가입한 후 새 키를 즉시 생성할 수 있습니다.

복잡한 라우팅 구성이나 특정 모델 선택이 필요하지 않습니다. 이 엔드포인트는 직접적인 텍스트 출력을 위해 설계된 단일 uncensored 대형 언어 모델을 제공합니다.

공식 OpenAI SDK 설치

인증 및 요청 형식을 자동으로 처리하려면 공식 SDK 패키지를 설치하세요. 이 라이브러리는 Python 및 Node.js 환경을 모두 지원하며 일관된 인터페이스를 제공합니다.

Python 사용자는 라이브러리를 가상 환경에 추가하기 위해 표준 pip install 명령을 실행하세요. Node.js 개발자는 npm을 사용하여 해당 패키지를 설치해야 합니다.

SDK는 JSON 페이로드 구조를 관리하므로 프롬프트 내용과 온도나 top_p와 같은 매개변수에 집중하기만 하면 됩니다.

스크립트나 모듈에서 라이브러리를 가져와서 설치를 확인할 수 있습니다. 이는 클라이언트가 당사 서버에 연결할 준비가 되었음을 보장합니다.

베이스 URL 및 API 키 구성

요청을 우리의 무장비 인프라로 라우팅하기 위해 특정 기본 URL로 SDK 클라이언트를 설정하세요. 사용 https://api.dolphinuncensored.com/v1 엔드포인트로 사용하세요.

API 키를 인증 헤더 또는 클라이언트 구성 객체에 설정하세요. 클라이언트는 이 키를 모든 요청에 자동으로 첨부합니다.

구성에서 모델 ID를 "uncensored"로 지정하세요. 이는 생성에 사용할 모델 버전을 서버에 알립니다.

첫 번째 채팅 완료 요청하기

연결을 확인하고 응답을 받기 위해 간단한 메시지를 보내세요. 이는 키가 유효하고 엔드포인트에 접근할 수 있음을 확인합니다.

시스템 프롬프트와 사용자 메시지를 사용하여 chat-completions 엔드포인트를 사용하세요. 응답에는 content 필드에 생성된 텍스트가 포함됩니다.

스트리밍 및 토큰 사용량 이해하기

전체 응답을 기다리는 대신 생성되는 대로 토큰을 받도록 스트리밍을 활성화하세요. 이는 긴 출력의 인지된 지연 시간을 개선합니다.

API는 스트림의 마지막 청크에 사용량 통계를 반환합니다. 청구 투명성을 위해 입력 및 출력 토큰 수를 추적할 수 있습니다.

요청 본문에서 stream 매개변수를 true로 설정하세요. 청크를 반복하여 최종 텍스트를 빌드하거나 실시간으로 처리합니다.

오류 및 거부 처리

API 키가 정확하고 만료되지 않았는지 확인하여 HTTP 401 오류를 처리하세요. 402 오류는 선불 크레딧이 부족함을 나타내며, 계속하려면 암호화폐를 통해 충전하세요.

429 상태는 분당 300회의 속도 제한에 도달했음을 의미합니다. 재시도하기 전에 잠시 기다리거나 동시성을 줄이세요.

이 모델은 미성년자를 포함한 성 콘텐츠가 관련된 요청을 거부합니다. 이는 하드 제한입니다. 기타 논쟁적이거나 성인 주제는 일반적으로 허용됩니다. 오류와 거부는 토큰 크레딧을 소모하지 않습니다.

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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