Dokumentace API a rychlý start

Základní URL a ověření

Základní URL pro všechny požadavky je https://api.veniceaiapipricing.com/v1. Ověřujete platnost předáním svého API klíče v Authorization hlavička jako bearer token. Toto nastavení funguje s jakýmkoli standardním SDK OpenAI. Nahraďte YOUR_API_KEY pomocí klíče vygenerovaného v ovládacím panelu vašeho účtu.

• Koncový bod: POST /v1/chat/completions
• Hlavička: Authorization: Bearer YOUR_API_KEY

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

Endpoint /v1/chat/completions

Odeslat historii konverzace na /v1/chat/completions pomocí uncensored ID modelu. API přijímá standardní objekty zpráv s role a content pole. Vstupní tokeny stojí $0.15 za milion, výstupní tokeny stojí $0.50 za milion. Chyby a odmítnutí nespotřebovávají kredit.

Tento endpoint podporuje pouze generování textu. Nezpracovává obrázky, audio ani vložení (embeddings). Odpovědi můžete streamovat nebo získat celý text v jednom objektu JSON.

Copyfrom openai import OpenAI

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

Streamované odpovědi (SSE)

Povolte streamování nastavením stream: true ve vašem těle požadavku. API vrací události odeslané serverem (SSE) pro každý vygenerovaný token. Poslední blok obsahuje statistiky celkového využití tokenů. Tato metoda snižuje vnímanou latenci u dlouhých odpovědí.

Zpracování streamu je zásadní pro aplikace v reálném čase. Můžete zpracovávat tokeny, jak přicházejí, místo čekání na úplné dokončení.

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)

Volání funkcí a režim JSON

API podporuje strukturované výstupy a definice nástrojů. Použijte response_format: {"type": "json_object"} abyste vynutili výstup JSON. Můžete také předat tools pro volání funkcí, což modelu umožňuje vracet strukturovaná data pro logiku vaší aplikace.

Tato funkce je užitečná pro extrakci dat nebo spouštění akcí. Model vrací volání nástrojů ve standardizovaném formátu. Poté můžete spustit své funkce a výsledky zpětně vložit do konverzace.

Parametry: Teplota, Top P, Seeds

Ovládejte kreativitu pomocí temperature a top_p. The seed parameter zajišťuje deterministické výstupy pro testování. Tyto parametry následují standardní konvence OpenAI. Jejich úpravou ovlivníte náhodnost generovaného textu.

Nastavit temperature na 0,7 pro vyváženou kreativitu. Použijte seed pro reprodukovatelné výsledky. API ignoruje nepodporované parametry gracefulně.

Limity rychlosti a omezení

Na klíč máte limit 300 požadků za minutu. Na klíč je povoleno maximálně 8 souběžných požadků. Velikost těla požadku je omezena na 8 MB. Kontextové okno má velikost 100 000 tokenů pro vstup i výstup dohromady. Maximální výstup na požadek je 16 000 tokenů.

Překročení těchto limitů vrací chybu 429. Ujistěte se, že váš klient správně zpracovává opakování. API klíč je unikátní pro každý účet; vygenerování nového klíče nahradí ten starý.

Node.js

Copyimport OpenAI from "openai";

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