Venice API-documentatie voor ontwikkelaars

Authenticatie en basis-URL

Verbind onmiddellijk door de basis-URL in te stellen op https://api.veniceapi.com/v1 en inclusief je API-sleutel in de Authorization header. Je verkrijgt deze sleutel direct na het aanmelden via Google of e-mail. Dit enkele model behandelt alle tekstgeneratie zonder routinglogica. Je hoeft geen meerdere endpoints of proxy-configuraties te beheren.

Houd je sleutel veilig. Elke account staat slechts één actieve sleutel tegelijk toe; het genereren van een nieuwe sleutel maakt de vorige ongeldig. Dit zorgt voor duidelijke toewijzing van tokenverbruik en facturatie.

Chat completions endpoint

Stuur tekstverzoeken naar de /v1/chat/completions endpoint met standaard HTTP POST-methoden. De API accepteert een JSON-payload met de modelnaam, systeeminstructies en gebruikersberichten.

Hier is een basisverzoekstructuur:

Copycurl https://api.veniceapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if the service blocks adult content in the test endpoint"}]
  }'

De respons retourneert gegenereerde tekst, tokengebruikscijfers en voltooiingsvlaggen. Je kunt het gedrag aanpassen met parameters zoals temperature of top_p. Deze instellingen regelen creativiteit en willekeur in de output.

Fouten retourneren standaard HTTP-codes. Een 401 geeft een ongeldige sleutel aan, terwijl 402 onvoldoende krediet signaleert. Gebruik deze codes om fouten soepel af te handelen in je automatiseringsworkflows.

Python SDK integratie

Gebruik de officiële OpenAI Python-bibliotheek om verbinding te maken met de ongecensureerde LLM. Configureer de client met de Venice-basis-URL en uw API-sleutel. Deze aanpak vereenvoudigt het opbouwen van verzoeken en het parseren van antwoorden.

Copyfrom openai import OpenAI

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

Deze methode werkt naadloos met bestaande codebases die zijn ontworpen voor OpenAI. Je kunt de basis-URL wijzigen zonder de applicatielogica aanzienlijk te wijzigen. De bibliotheek verwerkt serialisatie en netwerkverbindingen automatisch.

Onthoud dat de model-ID moet worden ingesteld op uncensored. Dit zorgt ervoor dat je het specifieke afgestemde model van Venice gebruikt. Andere modellen vertonen mogelijk niet hetzelfde gedragspatroon.

Node SDK-integratie

Integreer de API in JavaScript- of TypeScript-projecten met de OpenAI Node SDK. Stel de baseURL aan de Venice endpoint en geef je API-sleutel op. Deze setup ondersteunt zowel synchronische als asynchrone bewerkingen.

Copyimport OpenAI from "openai";

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

Deze integratie stelt je in staat om chatbots, contentgeneratoren of data-extractietools snel te bouwen. De SDK beheert de request-lifecycle, inclusief retries en foutafhandeling. Je kunt aangepaste headers doorgeven indien nodig voor geavanceerde use cases.

Zorg ervoor dat je de juiste versie van de SDK importeert. Oudere versies ondersteunen mogelijk niet alle functies die beschikbaar zijn in de Venice API. Controleer de documentatie voor compatibiliteitsdetails.

Streamingresponsen via SSE

Real-time uitvoer inschakelen door de stream parameter naar true. De API retourneert een Server-Sent Events (SSE)-stream in plaats van een compleet JSON-object. Hiermee kun je tokens weergeven terwijl ze worden gegenereerd.

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)

Streaming vermindert de waargenomen latentie voor gebruikers. Het is ideaal voor chatinterfaces of live dashboards. Het laatste deel van de stream bevat de statistieken voor tokenverbruik. Parse deze gegevens om de kosten nauwkeurig te volgen.

Verwerk verbreek van verbindingen soepel. Als de stream onderbreekt, kun je de request opnieuw proberen. De API garandeert geen volgorde als meerdere streams tegelijk actief zijn. Houd je snelheidslimieten nauwlettend in de gaten tijdens hoog verkeer.

Fouthantering en limieten

De API hanteert een rate limit van 300 verzoeken per minuut per key. Gelijktijdige verzoeken zijn beperkt tot 8 per key. Request bodies mogen niet groter zijn dan 8 MB. Het overschrijden van deze limieten retourneert een 429 Too Many Requests-fout.

De context windowgrootte is 100.000 tokens voor prompt en completion samen. De maximale uitvoer per verzoek is 16.000 tokens. Als max_tokens is niet ingesteld, dan is de limiet 2.048 tokens. Plan je invoer dienovereenkomstig om afkorting te voorkomen.

Veelvoorkomende fouten zijn onder meer 401 voor ongeldige sleutels en 402 voor onvoldoende tegoed. Verwerk deze codes om gebruikers op te roepen tot bijladen. Gebruik de supportpagina voor factureringsproblemen. Tegoed vervalt nooit, dus je kunt later bijladen.