Dokumentacja API Queen

Bazowy URL i autoryzacja

Uwierzytelnianie opiera się na standardowym tokenie Bearer przekazywanym w Authorization Nagłówek. To podejście zapewnia kompatybilność z istniejącymi SDK OpenAI bez wymogu niestandardowej logiki. Twój API_KEY jest generowany natychmiast po rejestracji za pomocą Google lub e-maila. Wszystkie żądania muszą być kierowane pod określony adres URL bazowy dostarczony dla usługi.

• URL bazowy: https://api.apiqueen.cc/v1
• Nagłówek: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

Wysyłanie żądań do /v1/chat/completions

Wyślij dane tekstowe do endpointu, aby otrzymać bezpośrednie odpowiedzi modelu. ID modelu to zawsze uncensored, który obsługuje różnorodne tematy bez standardowych odmów. Możesz określić takie parametry jak temperature i top_p kontrolować kreatywność. System oczekuje listy wiadomości w standardowym formacie czatu.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Parametry modelu: Temperatura, Top-P i Stop

Kontroluj generowanie odpowiedzi za pomocą standardowych parametrów LLM. Ustaw temperature między 0 a 2 dla zróżnicowanej losowości. Użyj top_p aby odfiltrować słowa o niskim prawdopodobieństwie. Zdefiniuj stop sekwencje do zatrzymywania wyjścia na konkretnych wyzwalaczach. Ustawienia te pozwalają na precyzyjne dostrajanie dla zadań kreatywnego pisania lub pobierania faktów.

API ignoruje nieobsługiwane parametry w sposób zgrany. Skup się na temperature, top_p, a także stop dla najlepszych wyników. Dostosuj te wartości w zależności od tolerancji szumu Twojej aplikacji.

Odpowiedzi strumieniowe i zużycie tokenów

Włącz strumieniowanie, ustawiając stream: true w Twoim żądaniu. API zwraca fragmenty danych za pomocą zdarzeń wysłanych przez serwer (SSE). Szczegóły użycia tokenów pojawiają się tylko w ostatnim fragmencie strumienia. Pozwala to na renderowanie w czasie rzeczywistym odpowiedzi w Twoim UI.

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)

Obsłuż częściowe odpowiedzi ostrożnie. Upewnij się, że Twój klient buforuje dane, aż strumień się zamknie.

Wywoływanie funkcji i tryb JSON

Używaj wywoływania funkcji do ekstrakcji danych ustrukturyzowanych. Zdefiniuj narzędzia w tools parametr. Model zwróci poprawny JSON, gdy response_format jest ustawione na {"type": "json_object"}. To zapewnia spójne parsowanie w aplikacjach downstream.

Ustaw tool_choice aby wymusić konkretne wywołania funkcji. Jest to przydatne w zautomatyzowanych przepływach pracy wymagających ścisłych formatów wyjściowych.

Obsługa błędów i limity szybkości

Monitoruj kody statusu HTTP dla powszechnych problemów. Błąd 401 oznacza, że Twój klucz API jest nieprawidłowy. Błąd 402 wskazuje na niewystarczające prepaydowane kredyty. Błędy nie zużywają Twojego salda tokenów. Limity szybkości wymuszają 300 żądań na minutę na klucz. Żądania współbieżne są ograniczone do 8. Okno kontekstu obsługuje łącznie 100,000 tokenów.

Obsłuż ponowienia z wykładniczym opóźnieniem. Sprawdź error obiekt w odpowiedziach JSON po szczegóły.