Dokumentacja API

Bazowy URL i autoryzacja

Końcówka API znajduje się pod adresem https://api.openrouteraiapi.com/v1. Przekaz swój klucz API w Authorization nagłówek jako token Bearer. To jedyna zmiana konieczna do przekierowania ruchu z obecnego dostawcy na nasz model bez cenzury.

Uwierzytelnianie jest ścisłe. Jeśli klucz jest nieobecny lub nieprawidłowy, serwer natychmiast zwraca błąd 401. Możesz wygenerować klucz natychmiast za pomocą Google lub e-mail w panelu. Chroń klucz, ponieważ daje on dostęp do Twojego salda kredytowego.

Punkt końcowy Uzupełnień Czat

Wysyłaj żądania POST do /v1/chat/completions z tablicą messages. Identyfikator modelu to uncensored. Ten pojedynczy model obsługuje wszystkie Twoje potrzeby generowania tekstu bez złożonej logiki routingu.

Oto standardowe żądanie za pomocą cURL do weryfikacji łączności i formatu odpowiedzi.

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

Odpowiedź zawiera wygenerowany tekst w choices[0].message.content pole. Możesz przeanalizować to bezpośrednio w przepływie pracy swojej aplikacji.

Integracja SDK Python

Użyj oficjalnego klienta Python OpenAI do bezproblemowego połączenia. Ustaw base_url i api_key zmiennych, aby wskazać na naszą infrastrukturę. To podejście minimalizuje zmiany w kodzie podczas zmiany dostawcy.

Copyfrom openai import OpenAI

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

Klient automatycznie obsługuje serializację i ponawianie prób. Otrzymujesz obiekt uzupełnienia zawierający tekst i statystyki użycia tokenów. Ta metoda jest idealna dla usług backendowych i skryptów.

Korzystanie z SDK Node.js

Zainicjuj pakiet Node.js OpenAI z niestandardowym podstawowym adresem URL. Pozwala to aplikacjom JavaScript na interakcję z modelem bez cenzury za pomocą znanych metod. SDK efektywnie zarządza żądaniami HTTP.

Copyimport OpenAI from "openai";

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

Wywołanie chat.completions.create() z Twoimi wiadomościami. Obiekt odpowiedzi umożliwia dostęp do wygenerowanej treści oraz danych użycia. Ta integracja dobrze sprawdza się na serwerach sieciowych i funkcjach brzegowych.

Odpowiedzi strumieniowe

Włącz strumieniowanie, ustawiając stream: true w Twoim żądaniu. Serwer zwraca Zdarzenia Wysyłane przez Serwer (SSE) w celu dostarczania tokenów w czasie rzeczywistym. Funkcja ta redukuje postrzeganą latencję dla użytkowników końcowych.

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)

Każdy fragment zawiera częściową zawartość. Ostatni fragment zawiera kompletne statystyki zużycia tokenów. Obsłuż te zdarzenia w swoim kliencie, aby aktualizować interfejs użytkownika stopniowo.

Limity, Błędy i Okno Kontekstu

Okno kontekstowe obsługuje 100,000 tokenów dla połączonego wejścia i wyjścia. Każde żądanie może wygenerować do 16,000 tokenów, lub 2,048, jeśli max_tokens jest nieustawione. Limity szybkości pozwalają na 300 żądań na minutę na klucz.

Błędy to standardowe kody HTTP. 401 oznacza nieprawidłowy klucz. 402 oznacza, że wyczerpały się Twoje środki z góry opłacone. 429 oznacza przekroczenie limitu. Żądania, które się nie powiedzą, nie zużywają kredytów. Błędy są darmowe.