Przewodnik szybkiego startu API Embeddings

Uwierzytelnianie

Uzyskaj dostęp do API za pomocą unikalnego klucza API wygenerowanego w panelu konta. Dołącz ten klucz do nagłówka Authorization każdego zapytania w schemacie Bearer. Podstawowy URL dla wszystkich endpointów to https://api.embeddingapis.com/v1. Ten URL działa z oficjalnymi SDK OpenAI oraz dowolnym klientem skonfigurowanym dla usług kompatybilnych z OpenAI. Upewnij się, że Twój klucz jest bezpieczny, ponieważ daje dostęp do Twojego przedpłaconego kredytu.

Każde konto jest ograniczone do jednego aktywnego klucza, który można wygenerować ponownie w dowolnym momencie. Wygenerowanie klucza ponownie natychmiast unieważnia poprzedni, więc zaktualizuj konfigurację szybko.

Endpoint Chat Completions

Wyślij prompty tekstowe do endpointu POST /v1/chat/completions. API obsługuje pojedynczy model bez cenzury oznaczony ID uncensored. Jest to model o otwartych wagach LLM dostrojony do odpowiadania bez odrzucania treści dla legalnych tematów dla dorosłych, fikcyjnych lub związanych z badaniami bezpieczeństwa. Przetwarza tekst i generuje tekst, co czyni go idealnym do post-processingu, podsumowań lub ekstrakcji w Twoim potoku.

Zstrukturuj zapytanie z tablicą messages zawierającą Twoje systemowe i użytkownika prompty. API zwraca odpowiedź JSON zawierającą wygenerowany tekst.

Copycurl https://api.embeddingapis.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 API. Ustaw base_url na nasz endpoint i podaj swój klucz API. To podejście pozwala wykorzystać istniejący kod klienta przy minimalnych zmianach. Klient obsługuje serializację i żądania sieciowe, zwracając strukturalne odpowiedzi, które możesz zparseować dla logiki aplikacji.

Upewnij się, że używasz najnowszej wersji SDK, aby obsługiwać wszystkie funkcje, w tym strumieniowanie i wywoływanie narzędzi. ID modelu pozostaje uncensored podczas wywoływania uzupełnień.

Copyfrom openai import OpenAI

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

Integracja z Node SDK

W środowiskach JavaScript lub TypeScript użyj OpenAI Node.js SDK. Skonfiguruj klienta z poprawnym base_url i kluczem API. To ustawienie zapewnia kompatybilność z istniejącymi potokami opartymi na Node. SDK zarządza połączeniem do endpointu POST /v1/chat/completions, pozwalając wysyłać prompty i otrzymywać uzupełnienia tekstu wydajnie.

Ta integracja jest odpowiednia do przetwarzania tekstu po stronie serwera, np. generowania opisów, skryptów lub ekstrakcji danych z dużych bloków tekstu.

Copyimport OpenAI from "openai";

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

Dla aplikacji o niskim opóźnieniu włącz strumieniowanie, ustawiając stream: true w zapytaniu. API zwraca strumień Server-Sent Events (SSE), dostarczając tokeny w miarę ich generowania. Jest to szczególnie przydatne dla interfejsów użytkownika w czasie rzeczywistym lub przy przetwarzaniu długich tekstów, gdzie natychmiastowa informacja zwrotna jest cenna.

Parseuj strumień SSE, aby obsłużyć częściowe odpowiedzi. Model bez cenzury obsługuje ten tryb, pozwalając reagować na treść, gdy jest generowana, bez czekania na całe uzupełnienie.

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 okno kontekstu

Okno kontekstu obsługuje 100 000 tokenów dla promptu i uzupełnienia łącznie. Zapytania przekraczające limit 8 MB ciała lub limit zapytań wynoszący 300 zapytań na minutę zakończą się niepowodzeniem. Błędy uwierzytelnienia zwrócą status 401, jeśli klucz jest nieprawidłowy. Gdy przedpłacony kredyt zostanie wyczerpany, zapytania nie powiedą się, ponieważ nie ma już kredytów na pokrycie użycia tokenów. Status 429 oznacza wyczerpanie limitu zapytań.

Zawsze obowiązuje twardy limit treści: zapytania zawierające treści seksualne z udziałem małoletnich są blokowane, niezależnie od innych ustawień. Wszystkie inne legalne treści dla dorosłych są przetwarzane bez odrzuceń.