Dokumentasi API dan Panduan Awal

URL Dasar dan Autentikasi

URL dasar untuk semua permintaan adalah https://api.veniceaiapipricing.com/v1. Anda mengautentikasi dengan meneruskan kunci API Anda di Authorization header sebagai token bearer. Konfigurasi ini berfungsi dengan SDK OpenAI standar mana pun. Ganti YOUR_API_KEY dengan kunci yang dihasilkan dari dasbor akun Anda.

• Endpoint: POST /v1/chat/completions
• Header: 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

Kirim riwayat percakapan Anda ke /v1/chat/completions menggunakan uncensored ID model. API menerima objek pesan standar dengan role dan content bidang. Token input berharga $0.15 per juta, dan token output berharga $0.50 per juta. Kesalahan dan penolakan tidak mengonsumsi kredit.

Endpoint ini mendukung generasi teks saja. Endpoint ini tidak menangani gambar, audio, atau embedding. Anda dapat melakukan streaming respons atau mengambil teks lengkap dalam satu objek 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)

Respons Streaming (SSE)

Aktifkan streaming dengan mengatur stream: true dalam badan permintaan Anda. API mengembalikan Server-Sent Events (SSE) untuk setiap token yang dihasilkan. Potongan terakhir berisi statistik total penggunaan token. Metode ini mengurangi latensi yang dirasakan untuk respons panjang.

Penanganan stream sangat penting untuk aplikasi real-time. Anda dapat memproses token saat tiba alih-alih menunggu penyelesaian penuh.

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)

Pemanggilan Fungsi dan Mode JSON

API mendukung output terstruktur dan definisi alat. Gunakan response_format: {"type": "json_object"} untuk memaksa output JSON. Anda juga dapat meneruskan tools untuk pemanggilan fungsi, memungkinkan model mengembalikan data terstruktur untuk logika aplikasi Anda.

Fitur ini berguna untuk mengekstrak data atau memicu tindakan. Model mengembalikan panggilan alat dalam format standar. Anda kemudian dapat mengeksekusi fungsi Anda dan mengembalikan hasil ke dalam percakapan.

Parameter: Suhu, Top P, dan Seeds

Kontrol kreativitas dengan temperature dan top_p. The seed parameter memastikan output deterministik untuk pengujian. Parameter ini mengikuti konvensi standar OpenAI. Menyesuaikannya memengaruhi keacakan teks yang dihasilkan.

Atur temperature ke 0.7 untuk kreativitas seimbang. Gunakan seed untuk hasil yang dapat direproduksi. API mengabaikan parameter yang tidak didukung dengan lancar.

Batas Laju dan Kendala

Anda dibatasi hingga 300 permintaan per menit per kunci. Maksimal 8 permintaan simultan diizinkan per kunci. Ukuran badan permintaan dibatasi hingga 8 MB. Jendela konteks adalah 100.000 token untuk input dan output digabungkan. Output maksimum per permintaan adalah 16.000 token.

Melebihi batas ini mengembalikan kesalahan 429. Pastikan klien Anda menangani percobaan ulang dengan tepat. Kunci API unik per akun; menghasilkan kunci baru menggantikan yang lama.

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);