Przewodnik szybkiego startu API OpenRouter dolphin

Bazowy URL i autoryzacja

Podstawowy adres URL dla wszystkich żądań to https://api.openrouterdolphin.com/v1. Uwierzytelniasz się, przekazując swój klucz API w Authorization

Copycurl https://api.openrouterdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 libraries for Python web scraping."}]
  }'

Uwierzytelnianie jest ścisłe. Nie obsługujemy wielu kluczy na konto. Wygenerowanie nowego klucza natychmiast unieważnia poprzedni. Gwarantuje to czyste śledzenie zużycia dla Twoich środków kredytowych.

Punkt końcowy: POST /v1/chat/completions

Wyślij dane tekstowe, aby generować odpowiedzi za pomocą uncensored model. Ten punkt końcowy obsługuje wszystkie standardowe uzupełnienia czatu. Definiujesz model, wiadomości i parametry w ciele żądania.

Copyfrom openai import OpenAI

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

API zwraca standardowy obiekt JSON zawierający wygenerowany tekst. Nie obsługuje osadzania (embeddings), obrazów ani audio. Skup się na przepływach pracy generowania tekstu. Model odpowiada na prompty bez filtrowania legalnych treści dla dorosłych lub kontrowersyjnych tematów.

Punkt końcowy: GET /v1/models

Pobierz dostępne modele za pomocą prostego żądania GET. Ten endpoint potwierdza identyfikator modelu, którego musisz użyć.

Copyimport OpenAI from "openai";

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

Odpowiedź zawiera listę uncensored model. Użyj tego dokładnego ID w swoich żądaniach uzupełnienia. API obsługuje tylko ten pojedynczy model. Nie ma logiki trasowania ani wyboru modelu. Wchodzisz w interakcję bezpośrednio z naszą dedykowaną instancją LLM uncensored.

Dane o strumieniowaniu i zużyciu

Włącz strumieniowanie, ustawiając stream: true. API zwraca fragmenty za pośrednictwem zdarzeń wysyłanych serwerowo (SSE). Każdy fragment zawiera część tekstu odpowiedzi.

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)

Ostatni fragment zawiera kompletne statystyki użycia tokenów. Płacisz ściśle za wygenerowane tokeny wyjściowe. Błędy i odrzucenia nie generują kosztów. Ta struktura pozwala na renderowanie odpowiedzi w czasie rzeczywistym w Twoich aplikacjach.

Parametry: Temperatura, Top P, Narzędzia

Kontroluj zachowanie generowania za pomocą standardowych parametrów. Ustaw temperature dla losowości i top_p do próbkowania jądra (nucleus sampling). Włącz wywoływanie funkcji, dostarczając tools tablicę.

Użyj response_format z {"type": "json_object"} dla ścisłego wyjścia JSON. Możesz również ustawić seed dla odtwarzalności. API obsługuje presence_penalty i frequency_penalty do dostrajania użycia słów. Te parametry działają dokładnie tak samo jak w standardowych klientach OpenAI.

Limity szybkości i rozmiar żądania

Każdy klucz API pozwala na 300 żądań na minutę. Możesz wysyłać jednocześnie do 8 żądań. Maksymalny rozmiar ciała żądania wynosi 8 MB. Okno kontekstowe obsługuje 100,000 tokenów w sumie dla danych wejściowych i wyjściowych.

Maksymalna długość wyjściowa na żądanie wynosi 16 000 tokenów. Jeśli nie ustawisz max_tokens, domyślnie to 2 048 tokenów. Przekroczenie tych limitów zwraca błąd 429. Zaplanuj strategię batchowania odpowiednio. Kredyty nie wygasają, więc możesz akumulować zużycie z czasem bez presji.