Integrasikan API Venice AI dalam Hitungan Menit

Pengaturan URL Dasar dan Autentikasi

API berada di https://api.veniceaiapi.com/v1. Anda mengautentikasi dengan satu kunci API yang diteruskan di Authorization header.

Daftar melalui Google atau email untuk mendapatkan kunci Anda secara instan. Tidak perlu nomor telepon. Gunakan kunci ini dengan SDK kompatibel OpenAI apa pun dengan mengatur URL dasar.

Setiap akun memiliki satu kunci aktif. Pembuatan kunci baru mencabut kunci lama secara langsung. Ini memastikan kontrol akses yang sederhana tanpa cakupan izin yang kompleks.

ID model yang harus Anda kirim adalah "uncensored". Ini adalah model open-weight yang di-tune untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah.

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

Anda dapat menguji konektivitas dengan permintaan GET sederhana ke /v1/models. Ini mengonfirmasi bahwa kunci Anda berfungsi sebelum Anda mengirim payload berat.

Endpoint /v1/chat/completions

Kirim prompt teks ke POST /v1/chat/completions dan menerima respons teks. Titik akhir ini menangani semua interaksi obrolan standar.

Sertakan array pesan Anda dengan bidang role dan content. Model memproses input dan mengembalikan kelengkapan. Anda dapat mengontrol panjang output menggunakan max_tokens parameter.

Output maksimum default adalah 2.048 token. Anda dapat meningkatkannya hingga 16.000 token per permintaan. Jendela konteks total memungkinkan 100.000 token untuk prompt dan penyelesaian gabungan.

Kesalahan dan penolakan tidak menguras kredit prabayar Anda. Ini berarti Anda hanya membayar untuk generasi token yang berhasil.

Parameter Model: Suhu, Top-P, dan Seed

Kontrol keacakan output menggunakan parameter LLM standar. Atur temperature untuk menyesuaikan kreativitas. Nilai yang lebih rendah membuat respons lebih deterministik dan fokus.

Gunakan top_p untuk sampling nuklir. Ini membatasi model untuk mempertimbangkan persentase massa probabilitas teratas. Ini membantu mencegah output yang berulang atau tidak masuk akal.

Atur seed untuk hasil yang dapat direproduksi. Ini berguna untuk debugging atau menguji variasi prompt tertentu. Anda juga dapat menggunakan stop urutan untuk menghentikan generasi lebih awal.

Parameter pendukung lainnya termasuk presence_penalty dan frequency_penalty. Ini membantu mengelola keragaman token dalam percakapan panjang.

Sesuaikan pengaturan ini agar sesuai dengan kasus penggunaan Anda. Roleplay diuntungkan dari temperatur yang lebih tinggi. Generasi kode mungkin memerlukan nilai yang lebih rendah.

Respons Streaming dengan Server-Sent Events

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan Server-Sent Events (SSE) alih-alih objek JSON tunggal.

Setiap chunk berisi konten teks parsial. Ini memungkinkan Anda menampilkan hasil secara waktu nyata kepada pengguna Anda. Ini secara signifikan meningkatkan latensi yang dirasakan untuk respons yang panjang.

Bagian terakhir mencakup statistik total penggunaan token. Anda dapat melacak konsumsi kredit Anda secara akurat secara real-time.

Tangani kesalahan stream dengan baik. Gangguan jaringan dapat memotong respons. Anda dapat melanjutkan atau mencoba ulang permintaan jika diperlukan.

Pemanggilan Fungsi dan Mode JSON

Gunakan pemanggilan fungsi untuk mengintegrasikan API dengan logika backend Anda. Tentukan alat dalam permintaan Anda dan model akan mengembalikan argumen JSON terstruktur.

Atur response_format: {"type": "json_object"} untuk memaksa output JSON yang ketat. Ini ideal untuk parsing data ke aplikasi Anda.

Pemanggilan fungsi bekerja berdampingan dengan streaming. Anda dapat menerima data terstruktur secara real-time. Ini memungkinkan interaksi multi-langkah yang kompleks.

Model memahami definisi alat dan mengeksekusinya sesuai. Anda menangani logika eksekusi alat dalam kode Anda.

Fitur ini membuat API cocok untuk membangun agen atau alur kerja otomatis.

Batas Laju dan Kendala Token

Setiap kunci API dibatasi hingga 300 permintaan per menit. Anda dapat memiliki 8 permintaan simultan pada waktu yang sama. Ini mencegah lonjakan tiba-tiba membebani sistem.

Ukuran badan permintaan maksimum adalah 8 MB. Pastikan payload Anda sesuai dengan batas ini. Jendela konteks besar mengonsumsi kuota ini dengan cepat.

Kesalahan umum termasuk 401 untuk kunci tidak valid dan 402 untuk kredit tidak cukup. Kesalahan 429 menunjukkan Anda telah mencapai batas kecepatan.

Pengembalian dana tidak tersedia untuk kredit. Namun, kesalahan seperti pembebanan ganda diperbaiki melalui Dukungan. Kredit Anda tidak pernah kedaluwarsa.

Harga adalah $0.15 per 1M token input dan $0.50 per 1M token output. Pengisian ulang hanya menggunakan kripto mulai dari $20 hingga $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)