Dolphin AI API Quickstart

Base URL & 인증

베이스 URL과 API 키를 클라이언트 구성에 설정하세요. 모든 요청은 다음을 통해 인증됩니다 Authorization 고유한 키를 사용한 헤더입니다. 당사 서비스는 openrouter dolphin AI 모델 변형이므로 이 엔드포인트를 사용하려면 OpenRouter에 계정이 필요하지 않습니다. 대시보드에서 키를 가져와 환경 변수에 연결하기만 하면 됩니다.

• Base URL: https://api.openrouterdolphinai.com/v1
• 헤더: Authorization: Bearer YOUR_API_KEY

이러한 구성은 당사 API가 정확한 엔드포인트 구조를 모방하기 때문에 모든 표준 OpenAI SDK와 작동합니다. 채팅 완료 엔드포인트만 상호작용하므로 통합이 단순하고 텍스트 생성에 집중됩니다.

첫 번째 요청

간단한 방법을 사용하여 텍스트 생성을 위한 첫 번째 메시지를 보내세요 POST 메서드. 모델 ID는 항상 uncensored, 특정 제한 없는 대화에 맞게 조정된 변형 버전을 정확하게 받을 수 있도록 합니다. 단일 모델을 직접 호스팅하므로 복잡한 라우팅 매개변수를 지정할 필요가 없습니다.

연결을 즉시 테스트하려면 다음 curl 명령어를 사용하세요:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

콘텐츠가 포함된 JSON 응답이 반환되면 키가 활성화되어 있으며 크레딧이 올바르게 차감되고 있음을 의미합니다. 401과 같은 오류는 키가 유효하지 않음을 나타내며, 402는 크립토를 통해 충전해야 함을 의미합니다. 이 직접적인 접근 방식은 다중 모델 라우터의 변동성을 피합니다.

Python SDK 통합

공식 OpenAI Python 라이브러리를 사용하여 기본 URL을 가리키도록 빠르게 통합하세요. 이렇게 하면 다음 같은 익숙한 메서드를 사용할 수 있습니다. chat.completions.create() 전체 로직을 다시 작성하지 않아도 됩니다. 라이브러리가 직렬화를 자동으로 처리하므로 HTTP 세부 사항보다는 프롬프트 설계에 집중할 수 있습니다.

기본 URL과 키로 클라이언트를 구성하세요:

Copyfrom openai import OpenAI

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

컨텍스트 창이 100,000 토크이므로 상당한 대화 기록을 전달할 수 있습니다. SDK는 토큰화 및 전송을 효율적으로 처리하여 불필요한 오버헤드나 형식 오류 없이 프롬프트가 모델에 도달하도록 보장합니다.

Node SDK 사용법

Node 개발자는 다음을 사용하여 동일한 결과를 얻을 수 있습니다. openai Python 버전과 마찬가지로 기본 base URL을 덮어써서 전용 서버로 향하게 해야 합니다. 이를 통해 요청이 제3자의 속도 제한이나 라우팅 지연 없이 무검열 모델로 직접 전달됩니다.

올바른 엔드포인트로 클라이언트를 초기화:

Copyimport OpenAI from "openai";

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

이 패턴은 동기식 호출과 async/await 패턴 모두에 적용됩니다. 동일한 함수 호출 내에서 스트리밍 응답을 하거나 JSON 모드를 직접 요청할 수 있어, 핵심 인증 설정을 변경하지 않고도 다양한 애플리케이션 아키텍처에 유연성을 제공합니다.

스트리밍 응답

다음 설정하여 실시간 텍스트 생성 활성화 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)

각 청크에는 마지막 부분에 토큰 사용 데이터가 포함되어 비용을 정확하게 추적할 수 있습니다. 스트리밍은 즉각적인 피드백이 사용자 참여를 향상시키는 채팅 인터페이스에 이상적입니다. 사용자가 새 메시지를 보내면 스트림을 언제든지 중지하여 부분 응답에 대한 크레딧을 절약할 수 있습니다.

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

예기치 않은 애플리케이션 중단 없이 기술적 한계를 이해하세요. 당사 API는 프롬프트와 완료를 합산하여 각 요청당 100,000개의 토큰 컨텍스트 윈도우를 적용합니다. 16,000개의 토큰 출력 제한을 초과하면 생성이 중단되므로 설정하십시오. max_tokens 비용을 통제하기 위해 accordingly.

일반적인 HTTP 상태 코드에는 잘못된 키에 대한 401, 불충분한 크레딧에 대한 402, 속도 제한에 대한 429가 포함됩니다. 키당 분당 요청은 300회로 제한됩니다. 이러한 제약은 모든 사용자에게 공정한 사용을 보장합니다. 사용 429 클라이언트 코드에 지수 백오프(exponential backoff)를 구현하여 피크 시간 중에도 원활한 작동을 보장하십시오.