Integrujte API Venice AI během několika minut

Nastavení základní URL a ověření

API žije na https://api.veniceaiapi.com/v1. Ověřujete platnost pomocí jediného API klíče předaného v Authorization hlavička.

Zaregistrujte se přes Google nebo e-mail pro okamžité získání svého klíče. Není vyžadováno telefonní číslo. Použijte klíč s libovolným SDK kompatibilním s OpenAI nastavením základní URL.

Každý účet obsahuje jeden aktivní klíč. Vygenerování nového klíče okamžitě zneplatní ten starý. To zajišťuje jednoduchou kontrolu přístupu bez složitých rozsahů oprávnění.

ID modelu, které musíte odeslat, je "uncensored". Jedná se o model s otevřenými váhami vyladěný tak, aby odpovídal bez odmítání obsahu pro legální použití dospělými.

• Základní URL: https://api.veniceaiapi.com/v1
• Hlavička Auth: Authorization: Bearer YOUR_API_KEY
• Model: uncensored

Můžete otestovat připojení jednoduchou GET požadavkem na /v1/models. To potvrzuje, že váš klíč funguje, než odešlete těžké payloady.

Endpoint /v1/chat/completions

Odesílejte textové prompty na POST /v1/chat/completions a obdržet textové odpovědi. Tento endpoint zpracovává všechny standardní chatové interakce.

Zadejte pole messages s poli role a content. Model zpracuje vstup a vrátí dokončení. Délku výstupu můžete ovládat pomocí max_tokens parametr.

Výchozí maximální výstup je 2 048 tokenů. Můžete jej zvýšit až na 16 000 tokenů na požadavek. Celkové kontextové okno umožňuje 100 000 tokenů pro prompt a dokončení dohromady.

Chyby a odmítnutí nespotřebovávají váš předplacený kredit. To znamená, že platíte pouze za úspěšnou generaci tokenů.

Parametry modelu: Teplota, Top-P a Seed

Ovládejte náhodnost výstupu pomocí standardních parametrů LLM. Nastavte temperature k úpravě kreativity. Nižší hodnoty činí odpovědi více deterministickými a zaměřenými.

Použít top_p pro nucleus sampling. Toto omezuje model na zvážení horního procenta pravděpodobnostní hmoty. Pomáhá to předcházet opakujícím se nebo nesmyslným výstupům.

Nastavit seed pro reprodukovatelné výsledky. To je užitečné pro ladění nebo testování konkrétních variant promptů. Můžete také použít stop sekvenční pro předčasné zastavení generování.

Mezi další podporované parametry patří presence_penalty a frequency_penalty. Tyto parametry pomáhají řídit diverzitu tokenů v dlouhých konverzacích.

Upravte tato nastavení podle případu použití. Roleplay prospívá vyšší teplotě. Generování kódu může vyžadovat nižší hodnoty.

Streamované odpovědi pomocí událostí odeslaných serverem

Povolte streamování nastavením stream: true ve vaší žádosti. API vrací Server-Sent Events (SSE) místo jednoho objektu JSON.

Každý chunk obsahuje částečný text. To vám umožňuje zobrazovat výsledky v reálném čase vašim uživatelům. Výrazně to zlepšuje vnímanou latenci u dlouhých odpovědí.

Poslední chunk zahrnuje statistiky celkového využití tokenů. Můžete přesně sledovat spotřebu vašich kreditů v reálném čase.

Zvládněte chyby streamování hladce. Síťové přerušení mohou odpověď zkrátit. Pokud je to potřeba, můžete požadavek obnovit nebo zopakovat.

Volání funkcí a režim JSON

Používejte volání funkcí k integraci API s logikou vašeho backendu. Definujte nástroje ve svém požadavku a model vrátí strukturované argumenty JSON.

Nastavit response_format: {"type": "json_object"} abyste vynutili přísný výstup JSON. To je ideální pro parsování dat do vaší aplikace.

Volání funkcí funguje společně se streamováním. Můžete přijímat strukturovaná data v reálném čase. To umožňuje složité vícekrokové interakce.

Model rozumí definicím nástrojů a podle nich je vykonává. Vy řešíte logiku vykonávání nástrojů ve svém kódu.

Tato funkce činí API vhodným pro tvorbu agentů nebo automatizované pracovní postupy.

Limity rychlosti a tokenová omezení

Každý klíč API je omezen na 300 požadavků za minutu. Můžete mít 8 souběžných požadavků najednou. To zabraňuje náhlým vlnám, které by mohly přetížit systém.

Maximální velikost těla požadavku je 8 MB. Ujistěte se, že vaše payloady se vejdo do tohoto limitu. Velká kontextová okna tuto kvótu rychle spotřebují.

Mezi běžné chyby patří 401 pro neplatné klíče a 402 pro nedostatečný kredit. Chyba 429 znamená, že jste dosáhli limitu rychlosti.

Za kredit není k dispozici refundace. Nicméně chyby, jako je dvojí účtování, se opravují přes podporu. Váš kredit nikdy nevyprší.

Cena je 0,15 $ za 1M vstupních tokenů a 0,50 $ za 1M výstupních tokenů. Dobití je pouze pomocí kryptoměn v částkách 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);

Streamování

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)