Integreer de Venice AI API in Minuten

Basis-URL en authenticatiesetup

De API is actief op https://api.veniceaiapi.com/v1. Je authenticeert met een enkele API-sleutel die wordt meegegeven in de Authorization header.

Meld je aan via Google of e-mail om je sleutel direct te ontvangen. Er is geen telefoonnummer nodig. Gebruik de sleutel met elke OpenAI-compatibele SDK door de basis-URL in te stellen.

Elk account heeft één actieve sleutel. Het genereren van een nieuwe intrekt de oude sleutel direct. Dit zorgt voor eenvoudig toegangsbeheer zonder complexe machtigingsbereiken.

De model-ID die je moet verzenden is "uncensored". Het is een open-weight model getuned om zonder inhoudsweigeringen te antwoorden voor wettelijk volwassen gebruik.

• Basis-URL: https://api.veniceaiapi.com/v1
• Auth Header: Authorization: Bearer YOUR_API_KEY
• Model: uncensored

U kunt de connectiviteit testen met een eenvoudige GET-request naar /v1/models. Dit bevestigt dat je sleutel werkt voordat je zware payloads verstuurt.

Het /v1/chat/completions-eindpunt

Stuur tekstprompts naar POST /v1/chat/completions en ontvang tekstantwoorden. Dit eindpunt verwerkt alle standaard chatinteracties.

Voeg uw messages-array toe met role- en content-velden. Het model verwerkt de invoer en retourneert een voltooiing. U kunt de uitvoerlengte beheren met de max_tokens parameter.

De standaard maximale uitvoer is 2.048 tokens. Je kunt dit verhogen tot 16.000 tokens per verzoek. Het totale contextvenster biedt ruimte voor 100.000 tokens voor prompt en voltooiing samen.

Fouten en weigeringen verbruiken geen van uw vooruitbetaalde tegoed. Dit betekent dat u alleen betaalt voor succesvolle token-generatie.

Modelparameters: temperatuur, top-p en seed

Stuur de willekeur van de output aan met standaard LLM-parameters. Stel temperature aanpassen van creativiteit. Lagere waarden maken antwoorden meer deterministisch en gericht.

Gebruik top_p voor nucleus sampling. Dit beperkt het model tot het overwegen van het bovenste percentage waarschijnlijkheidsmassa. Het helpt repetitieve of onzinnige outputs te voorkomen.

Instellen seed voor reproduceerbare resultaten. Dit is handig voor debugging of het testen van specifieke promptvariaties. Je kunt ook stop sequenties om de generatie vroegtijdig te stoppen.

Andere ondersteunde parameters zijn presence_penalty en frequency_penalty. Deze helpen bij het beheren van tokendiversiteit in lange gesprekken.

Pas deze instellingen aan op je use case. Roleplay baat bij een hogere temperatuur. Codegeneratie heeft mogelijk lagere waarden nodig.

Streaming-responsen met Server-Sent Events

Activeer streaming door stream: true in je verzoek. De API retourneert Server-Sent Events (SSE) in plaats van een enkel JSON-object.

Elke chunk bevat gedeeltelijke tekstinhoud. Hiermee kun je resultaten realtime aan je gebruikers tonen. Dit verbetert de waargenomen latentie voor lange responsen aanzienlijk.

De laatste chunk bevat de statistieken over het totale tokengebruik. Je kunt je kredietverbruik nauwkeurig in realtime bijhouden.

Verwerk streamfouten op een beheersbare manier. Netwerkonderbrekingen kunnen het antwoord afkappen. Je kunt het verzoek indien nodig hervatten of opnieuw proberen.

Function Calling en JSON-modus

Gebruik function calling om de API te integreren met uw backend-logica. Definieer tools in uw verzoek en het model retourneert gestructureerde JSON-argumenten.

Instellen response_format: {"type": "json_object"} om strikte JSON-uitvoer af te dwingen. Dit is ideaal voor het parseren van gegevens in uw applicatie.

Function calling werkt samen met streaming. Je kunt gestructureerde data in realtime ontvangen. Dit maakt complexe multi-step interacties mogelijk.

Het model begrijpt tooldefinities en voert ze uit zoals behoord. Jij verzorgt de uitvoerlogica van de tools in je code.

Deze functie maakt de API geschikt voor het bouwen van agents of geautomatiseerde workflows.

Rate Limits en tokenbeperkingen

Elke API-sleutel is beperkt tot 300 verzoeken per minuut. Je kunt op elk moment 8 gelijktijdige verzoeken uitvoeren. Dit voorkomt dat plotselinge pieken het systeem overweldigen.

De maximale grootte van de request body is 8 MB. Zorg ervoor dat je payloads binnen deze limiet passen. Grote contextvensters verbruiken deze quota snel.

Veelvoorkomende fouten zijn onder meer 401 voor ongeldige sleutels en 402 voor onvoldoende tegoed. Een 429-fout geeft aan dat je de limiet voor verzoeken hebt bereikt.

Restituties zijn niet beschikbaar voor tegoed. Fouten, zoals dubbele afschrijvingen, worden echter opgelost via Support. Uw tegoed vervalt nooit.

Prijzen zijn $0,15 per 1M invoertokens en $0,50 per 1M uitvoertokens. Top-ups zijn alleen via crypto van $20 tot $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);

Streaming

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)