Dolphin nsfw API 문서

Base URL 및 인증

표준 OpenAI 호환 베이스 URL을 사용합니다. 대시보드에서 생성한 키로 기존 API 키를 교체하세요. 베이스 URL 재정을 허용하는 모든 클라이언트 라이브러리를 지원합니다.

• Base URL: https://api.dolphinnsfw.com/v1
• 인증: Authorization 헤더의 Bearer 토큰 Authorization 헤더입니다.

인증은 즉시 이루어집니다. 키는 생성 직후 바로 작동합니다. 전화번호가 필요하지 않습니다. Google 또는 이메일로 가입하세요. 대시보드에는 키가 한 번 표시됩니다. 오류는 무료입니다. 거부도 무료입니다. 이는 실제 토큰에만 지불한다는 것을 보장합니다.

첫 번째 요청

채팅 엔드포인트로 완료 요청 전송. 모델 ID는 uncensored성인 주제를 거부 없이 처리합니다. 표준 JSON 구조를 사용하세요. 요청 본문에는 메시지와 매개변수가 포함됩니다.

연결을 테스트하기 위한 간단한 curl 명령어입니다. 짧은 프롬프트를 보내며, 응답은 생성된 텍스트를 반환합니다. 성공 여부를 상태 코드로 확인하세요.

Copycurl https://api.dolphinnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word scene of two dolphins mating at sunset"}]
  }'

이것은 간단한 텍스트 생성 작업에 작동합니다. 온도와 top_p를 조정할 수 있습니다. 모델은 빠르게 응답합니다. 복잡한 설정이 필요하지 않습니다.

Python SDK 통합

공식 OpenAI Python 라이브러리를 사용하세요. base URL을 우리 엔드포인트로 지정하세요. API 키를 전달하세요. 코드는 표준 GPT 사용법과 동일하게 유지됩니다. 이는 통합 시간을 크게 단축합니다.

라이브러리를 설치합니다. 클라이언트를 구성합니다. 메시지를 보냅니다. 응답 객체에는 생성된 텍스트가 포함됩니다. 응답에서 토큰 사용량을 확인하여 비용을 추적할 수 있습니다.

Copyfrom openai import OpenAI

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

Node.js 클라이언트를 초기화합니다. 베이스 URL을 가리키세요. API 키를 사용하세요. 구문은 공식 문서와 유사합니다. 이는 언어 간 일관성을 보장합니다.

클라이언트 인스턴스를 생성하세요. 모델을 정의하고 프롬프트를 전송합니다. 응답에는 콘텐츠가 포함됩니다. JSON을 쉽게 구문 분석할 수 있습니다. 서버 사이드 렌더링에 적합하며 서버리스 함수에도 잘 맞습니다.

Copyimport OpenAI from "openai";

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

SDK는 스트리밍을 내부적으로 처리합니다. 수동으로 가져올 수도 있습니다. 이는 유연성을 제공합니다. 아키텍처에 맞는 방법을 선택하세요.

스트리밍 및 도구 사용

실시간 출력을 위해 스트리밍을 활성화하세요. stream 매개변수를 true로 설정하세요. API는 서버 전송 이벤트를 통해 청크를 전송합니다. 이는 지각된 지연 시간을 줄여줍니다. 사용자는 텍스트가 생성되는 대로 볼 수 있습니다.

함수 호출이 지원됩니다. 요청에 도구를 정의하세요. 모델은 도구 호출을 반환합니다. 당신이 이를 실행합니다. 그런 다음 결과를 다시 전달하세요. 이는 복잡한 워크플로우를 가능하게 합니다. JSON 모드도 제공됩니다. 설정 response_format 수신하여 {"type": "json_object"}. 이는 엄격한 출력 형식을 보장합니다.

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)

스트리밍은 모든 매개변수와 함께 작동합니다. Temperature와 top_p는 청크별로 적용되며, 이를 통해 세밀한 제어가 가능합니다. 생성을 조기에 중단할 수 있습니다. 마지막 청크에는 총 토큰 사용량이 포함됩니다.

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

컨텍스트 윈도우는 100,000 토큰입니다. 여기에는 프롬프트와 생성된 응답이 포함됩니다. 최대 출력은 16,000 토큰입니다. 요청 본문 크기는 8 MB입니다. 속도 제한은 분당 300회 요청입니다. 동시성은 키당 8개 요청입니다.

오류를 우아하게 처리하세요. 401 오류는 유효하지 않은 키를 의미합니다. 402 오류는 크레딧이 없음을 나타냅니다. 429 오류는 속도 제한을 신호합니다. 이는 표준 HTTP 코드입니다. 클라이언트는 재시도하거나 사용자에게 알려야 합니다.

가격은 투명합니다. 입력 토큰은 100만 개당 $0.15입니다. 출력 토큰은 100만 개당 $0.50입니다. 오류는 크레딧을 소모하지 않습니다. 이는 예산을 보호합니다. 선불 크레딧은 만료되지 않습니다. 체험 크레딧으로 먼저 테스트할 수 있습니다.