Jedno API: Przewodnik szybkiego startu

Bazowy URL i uwierzytelnianie

Zacznij od wskazania swojego klienta na nasz dedykowany endpoint. To kompatybilne z OpenAI API wykorzystuje standardowe nagłówki uwierzytelniające, więc musisz zmienić tylko dwie wartości w konfiguracji.

Bazowy URL to https://api.onekeyllmapi.com/v1. Wygeneruj swój unikalny klucz API na stronie logowania. Nie jest wymagana karta, aby rozpocząć, a klucz jest wyświetlany natychmiast po rejestracji. Przechowuj ten klucz bezpiecznie; uwierzytelnia on wszystkie zapytania do usługi.

Podstawowe uzupełnienie

Wyślij prosty prompt tekstowy, aby otrzymać bezpośrednią odpowiedź. To jest sedno naszej oferty API AI dla deweloperów. Model zwraca tekst bez odrzucania treści dla prawnego użytku dorosłego, co czyni go idealnym do zadań twórczych lub bez ograniczeń.

• ID modelu: uncensored
• Endpoint: POST /v1/chat/completions
• Kontekst: 100 000 tokenów

Wykonaj swoje pierwsze zapytanie za pomocą tego przykładu:

Copycurl https://api.onekeyllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Integracja z Python SDK

Użyj oficjalnej biblioteki OpenAI Python do interakcji z naszą usługą. Jedyne zmiany, jakie musisz wprowadzić, to base_url i api_key. Dzięki temu Twoja istniejąca logika działa bez modyfikacji.

• Zainstaluj przez pip install openai
• Ustaw zmienne środowiskowe lub przekaż bezpośrednio w inicjalizacji klienta
• Wywołaj chat.completions.create() jak zwykle

Skonfiguruj klienta w ten sposób:

Copyfrom openai import OpenAI

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

Użycie Node.js SDK

Zintegruj się z projektami JavaScript lub TypeScript za pomocą standardowego pakietu OpenAI Node. Wskaż klientowi nasz URL i podaj swój klucz. To podejście zachowuje kompatybilność z każdą strukturą klienta kompatybilnego z OpenAI.

• Zainstaluj przez npm install openai
• Zainicjuj z niestandardowym bazowym URL
• Użyj standardowych wzorców async/await

Przykład inicjalizacji:

Copyimport OpenAI from "openai";

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

Odpowiedzi strumieniowe

Otrzymuj odpowiedzi token po tokenie, aby zmniejszyć postrzeganą opóźnienie. Nasze API strumieniowania obsługuje Server-Sent Events (SSE), pozwalając wyświetlać wyjście w miarę jego generowania. Jest to przydatne w interfejsach czatu lub aplikacjach czasu rzeczywistego.

• Ustaw stream: true w swoim zapytaniu
• Przetwarzaj strumień SSE po stronie klienta
• Obsługuj częściowe tokeny wydajnie

Włącz strumieniowanie w swoim kodzie:

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)

Limity, błędy i kontekst

Zrozum ograniczenia, aby zbudować solidne integracje. API obsługuje okno kontekstu API 100k, pozwalając na długie dokumenty lub rozmowy. Zapytania są ograniczone do rozmiaru ciała 8 MB.

Powszechne błędy obejmują 401 dla nieprawidłowych kluczy, 402 gdy przedpłacony kredyt zostanie wyczerpany oraz 429 za przekroczenie 300 zapytań na minutę. Kredyt rozliczany za zużycie nigdy nie wygasa, a Ty możesz doładować go od $10. Wywoływanie funkcji jest obsługiwane dla wykonywania funkcji.