Zintegruj interfejs API Venice AI w kilka minut

Konfiguracja bazowego URL i autoryzacji

API żyje w https://api.veniceaiapi.com/v1. Uwierzytelniasz się za pomocą pojedynczego klucza API przekazanego w Authorization Nagłówek.

Zarejestruj się przez Google lub adres e-mail, aby natychmiast uzyskać swój klucz. Nie jest wymagany numer telefonu. Użyj klucza z dowolnym SDK kompatybilnym z OpenAI, ustawiając adres URL bazowy.

Każde konto posiada jeden aktywny klucz. Wygenerowanie nowego natychmiast cofa ważność starego klucza. Zapewnia to prostą kontrolę dostępu bez złożonych zakresów uprawnień.

Identyfikator modelu, który musisz wysłać, to "uncensored". Jest to model o otwartych wagach dostrojony do odpowiadania bez odrzucania treści dla legalnego użytku dorosłych.

• URL bazowy: https://api.veniceaiapi.com/v1
• Nagłówek Auth: Authorization: Bearer YOUR_API_KEY
• Model: uncensored

Możesz przetestować łączność za pomocą prostego żądania GET do /v1/models.To potwierdza, że Twój klucz działa przed wysłaniem ciężkich ładunków.

Endpoint /v1/chat/completions

Wyślij prompty tekstowe do POST /v1/chat/completions i otrzymaj odpowiedzi tekstowe. Ten endpoint obsługuje wszystkie standardowe interakcje czatu.

Dołącz swoją tablicę wiadomości z polami role i content. Model przetwarza dane wejściowe i zwraca uzupełnienie. Możesz kontrolować długość wyjścia za pomocą max_tokens parametr.

Domyślna maksymalna liczba tokenów wyjściowych wynosi 2,048. Możesz zwiększyć ją do 16,000 tokenów na żądanie. Całkowite okno kontekstowe pozwala na 100,000 tokenów dla promptu i uzupełnienia łącznie.

Błędy i odrzucenia nie zużywają Twojego kredytu z góry opłaconego. Oznacza to, że płacisz tylko za pomyślną generację tokenów.

Parametry modelu: Temperatura, Top-P i Seed

Steruj losowością outputu za pomocą standardowych parametrów LLM. Ustaw temperature do dostosowania kreatywności. Niższe wartości sprawiają, że odpowiedzi są bardziej deterministyczne i skupione.

Użyj top_p do próbkowania jądra (nucleus sampling). Ogracza to model do rozważania najwyższego procenta masy prawdopodobieństwa. Pomaga to zapobiegać powtarzalnym lub bezsensownym odpowiedziom.

Ustaw seed dla odtwarzalnych wyników. Jest to przydatne przy debugowaniu lub testowaniu konkretnych wariantów promptów. Możesz również użyć stop sekwencje do wcześniejszego zatrzymania generowania.

Inne obsługiwane parametry obejmują presence_penalty i frequency_penalty. Pomagają zarządzać różnorodnością tokenów w długich rozmowach.

Dostosuj te ustawienia do przypadku użycia. Roleplay czerpie korzyści z wyższej temperatury. Generowanie kodu może wymagać niższych wartości.

Odpowiedzi strumieniowe z zdarzeniami wysłanymi przez serwer

Włącz strumieniowanie, ustawiając stream: true w Twoim żądaniu. API zwraca zdarzenia wysyłane serwerowo (SSE) zamiast pojedynczego obiektu JSON.

Każdy chunk zawiera częściową zawartość tekstu. Pozwala to na wyświetlanie wyników w czasie rzeczywistym dla użytkowników. Znacząco poprawia postrzeganą opóźnienie dla długich odpowiedzi.

Ostatni fragment zawiera statystyki całkowitego zużycia tokenów. Możesz dokładnie śledzić zużycie kredytu w czasie rzeczywistym.

Obsługuj błędy strumieniowania w sposób elegancki. Przerwania sieciowe mogą uciąć odpowiedź. Możesz wznowić lub ponowić żądanie, jeśli jest to konieczne.

Wywoływanie funkcji i tryb JSON

Używaj wywoływania funkcji do integracji API z logiką backendu. Zdefiniuj narzędzia w żądaniu, a model zwróci ustrukturyzowane argumenty JSON.

Ustaw response_format: {"type": "json_object"} aby wymusić ścisły wynik JSON. Jest to idealne do parsowania danych do Twojej aplikacji.

Wywoływanie funkcji działa wraz ze strumieniowaniem. Możesz otrzymywać dane strukturalne w czasie rzeczywistym. To umożliwia złożone interakcje wieloetapowe.

Model rozumie definicje narzędzi i wykonuje je zgodnie z przeznaczeniem. Ty obsługujesz logikę wykonania narzędzia w swoim kodzie.

Ta funkcja sprawia, że API nadaje się do budowania agentów lub zautomatyzowanych przepływów pracy.

Limity szybkości i ograniczenia tokenów

Każdy klucz API jest ograniczony do 300 żądań na minutę. Możesz mieć 8 żądań równoległych w tym samym czasie. Zapobiega to nagłym skokom, które mogłyby przeciążyć system.

Maksymalny rozmiar ciała żądania to 8 MB. Upewnij się, że Twoje ładunki mieszczą się w tym limicie. Duże okna kontekstu szybko zużywają ten limit.

Typowe błędy obejmują 401 dla nieprawidłowych kluczy oraz 402 dla niewystarczającego kredytu. Błąd 429 oznacza, że przekroczyłeś limit szybkości.

Zwroty nie są dostępne dla kredytu. Jednak błędy, takie jak podwójne obciążenia, są naprawiane przez Pomoc. Twój kredyt nigdy nie wygasa.

Ceny wynoszą $0.15 za 1M tokenów wejściowych i $0.50 za 1M tokenów wyjściowych. Doładowania są wyłącznie kryptowalutami w kwotach od $20 do $500.

cURL

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

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Strumieniowanie

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)