Snelstart voor Vibevoice-pipelines

Vereisten

Voordat je integreert, zorg dat je een actief account hebt. Meld je aan via Google of e-mail op de pagina API-sleutel krijgen om je unieke sleutel direct te ontvangen. Je hebt geen creditcard nodig voor de initiële proef van $0,50. Onze ongecensureerde llm serveert de model id "uncensored" via een standaard endpoint. De base URL is https://api.vibevoice.top/v1. Deze setup werkt met elke OpenAI SDK, waardoor het een drop-in vervanging is voor veel bestaande pipelines.

Authenticatie

Geef je API-sleutel mee in de Authorization header. De indeling moet "Bearer YOUR_API_KEY" zijn. Als de sleutel ontbreekt of ongeldig is, retourneert de API een 401-fout. Omdat we ons richten op tekstverwerking, zorg dat je pipeline alleen tekstgegevens verstuurt. De sleutel is gekoppeld aan één account; het genereren van een nieuwe sleutel vervangt de oude direct. Deze eenvoud stelt je in staat snel te itereren in je ontwikkelomgeving.

Een verzoek versturen

Maak een POST-verzoek naar /v1/chat/completions. Voeg het model id, je berichten en eventuele parameters toe. Hier is een basisvoorbeeld met cURL:

Copycurl https://api.vibevoice.top/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."}]
  }'

Dit verzoek stuurt een eenvoudige instructie naar het model. De respons bevat de gegenereerde tekst. Je kunt parameters aanpassen zoals temperature voor creativiteit of strikte limieten instellen voor de outputlengte. Deze directe aanpak is ideaal voor het genereren van scripts, bijschriften of promptvariaties voor andere tools.

Python SDK-integratie

Gebruik de officiële OpenAI Python-bibliotheek. Configureer de base URL zodat deze naar onze service verwijst. Geef je API-sleutel door als api_key. Hierdoor kun je bekende methoden gebruiken zoals client.chat.completions.create(). Het is een openai-compatible api, dus je bestaande codestructuur vereist waarschijnlijk minimale aanpassingen. Deze methode is perfect voor backendverwerking of data-extractietaken.

Copyfrom openai import OpenAI

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

Vergeet niet om uitzonderingen af te handelen. Netwerkfouten of rate limits kunnen je pipeline onderbreken. Het loggen van de respons helpt bij het debuggen waarom een specifieke prompt mogelijk is geweigerd of onverwachte output heeft gegenereerd.

Node SDK-integratie

Gebruik voor JavaScript-omgevingen het openai npm-pakket. Stel de apiKey en baseURL-eigenschappen in in het configuratieobject. Dit zorgt ervoor dat verzoeken naar het juiste endpoint gaan. De Node SDK ondersteunt dezelfde parameters als de Python-versie. Het is ideaal voor webservers of edge-functies die tekst op verzoek moeten genereren.

Copyimport OpenAI from "openai";

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

Zorg ervoor dat je de levenscyclus van het clientobject beheert om resourcelekken te voorkomen. Deze integratie is robuust voor het afhandelen van asynchrone tekstgeneratietaken in moderne webapplicaties.

Streaming-responsen

Schakel streaming in door stream in te stellen op true in je verzoek. De API retourneert gegevens in chunks zodra ze zijn gegenereerd. Dit is nuttig voor realtime-weergaven of progressieve tekstrendering. De laatste chunk bevat de volledige token-gebruiksstatistieken. Streaming vermindert de waargenomen latentie voor eindgebruikers.

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)

Verwerk de stream correct om ervoor te zorgen dat alle gegevens worden verwerkt. Als de verbinding verbroken raakt, mis je mogelijk de finale gebruiksgegevens. Deze functie is waardevol voor applicaties die tekst willen weergeven terwijl deze wordt geschreven.