ID ▾

unfilteredaiapi.comhttps://api.unfilteredaiapi.com/v1

Unfiltered AI

API LLM mentah, tanpa sensor, untuk pengembang.

Unfiltered AIDapatkan kunci API

API AI Node JS: Streaming, Alat, dan Error di Express

Tutorial api ai node js ini membawa Anda dari folder kosong ke route Express yang mengalirkan balasan chat, memanggil alat, dan menangani error batas laju. Anda hanya perlu mengubah base URL dan kunci di paket OpenAI resmi, lalu kirim model uncensored.

Roda hexagonal terhubung ke rak server yang mengalirkan partikel cahaya ke jendela browser

Poin utama

  • Instal paket openai dan atur baseURL ke https://api.unfilteredaiapi.com/v1.
  • Gunakan streaming dengan stream: true dan kirimkan potongan data ke browser sebagai peristiwa yang dikirim server.
  • Panggilan alat tiba sebagai tool_calls; kembalikan hasil dengan role tool.
  • Kode status 429 berarti permintaan dibatasi laju (rate limited), kelebihan konkurensi, atau kelebihan beban sementara; coba lagi setelah penundaan Retry-After.

Persiapan: instal dan kirim permintaan pertama

Anda memerlukan Node 18 atau yang lebih baru. Buat proyek, instal SDK dan Express, lalu beralih ke modul ES.

mkdir ai-node && cd ai-node
npm init -y
npm pkg set type=module
npm install openai express
# base URL: https://api.unfilteredaiapi.com/v1   model: uncensored
export AI_API_KEY="YOUR_KEY"

Dapatkan kunci dari halaman kunci API. Akun baru dapat mengklaim kredit uji coba senilai $0,50 dengan satu klik, berlaku selama 7 hari. Lalu buat client.js:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.unfilteredaiapi.com/v1",
  apiKey: process.env.AI_API_KEY,
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a tavern keeper." }],
});
console.log(res.choices[0].message.content);

Jalankan dengan node client.js. Setiap cuplikan kode di bawah ini mendefinisikan ulang klien agar dapat berjalan sendiri. Itulah seluruh migrasi jika Anda sudah menggunakan paket OpenAI: baseURL yang berbeda, kunci Anda, dan ID model. Layanan ini kompatibel dengan OpenAI dan hanya teks, dengan jendela konteks 100.000 token. Lihat dokumentasi untuk setiap metode yang didukung.

Alirkan balasan

Streaming mengirim token saat token tersebut dihasilkan, sehingga pengguna melihat teks secara langsung. Atur stream: true dan iterasi melalui chunk:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.unfilteredaiapi.com/v1",
  apiKey: process.env.AI_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Describe a rainy harbor town." }],
  stream: true,
  stream_options: { include_usage: true },
});

for await (const chunk of stream) {
  const delta = chunk.choices[0]?.delta?.content;
  if (delta) process.stdout.write(delta);
  if (chunk.usage) console.log("\nusage:", chunk.usage);
}

Penggunaan data tiba di chunk terakhir, yang memungkinkan Anda mencatat hitungan token nyata per permintaan. Ingat satu fakta: permintaan streaming menempati slot konkurensi hingga aliran berakhir. Jika klien terputus, batalkan panggilan upstream agar slot segera dibebaskan.

Route Express yang mengalirkan ke browser

Berikut adalah server kecil dengan route POST /chat. Route ini meneruskan stream sebagai server-sent events dan membatalkan permintaan upstream saat browser menutup koneksi.

import express from "express";
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.unfilteredaiapi.com/v1",
  apiKey: process.env.AI_API_KEY,
});

const app = express();
app.use(express.json({ limit: "1mb" }));

app.post("/chat", async (req, res) => {
  const { messages } = req.body;
  if (Array.isArray(messages) === false) return res.status(400).json({ error: "messages required" });

  res.set({
    "Content-Type": "text/event-stream",
    "Cache-Control": "no-cache",
    Connection: "keep-alive",
  });

  const controller = new AbortController();
  req.on("close", () => controller.abort());

  try {
    const stream = await client.chat.completions.create(
      { model: "uncensored", messages, stream: true },
      { signal: controller.signal }
    );
    for await (const chunk of stream) {
      const delta = chunk.choices[0]?.delta?.content;
      if (delta) res.write("data: " + JSON.stringify({ delta }) + "\n\n");
    }
    res.write("data: [DONE]\n\n");
  } catch (err) {
    res.write("data: " + JSON.stringify({ error: err.status || 500 }) + "\n\n");
  } finally {
    res.end();
  }
});

app.listen(3000, () => console.log("listening on 3000"));

Jangan letakkan kunci di kode browser. Rute di atas menjaga kunci tetap di server, sesuai tempatnya. Pola yang sama ditunjukkan dalam bahasa Python di artikel backend chatbot FastAPI.

Panggil alat

Pemanggilan alat mengikuti format OpenAI: Anda mendeskripsikan fungsi dalam tools, model membalas dengan tool_calls, Anda menjalankan fungsi tersebut, dan mengirimkan hasilnya kembali sebagai pesan dengan role: "tool".

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.unfilteredaiapi.com/v1",
  apiKey: process.env.AI_API_KEY,
});

const tools = [{
  type: "function",
  function: {
    name: "roll_dice",
    description: "Roll a die with the given number of sides",
    parameters: {
      type: "object",
      properties: { sides: { type: "integer" } },
      required: ["sides"],
    },
  },
}];

const messages = [{ role: "user", content: "Roll a d20 for my attack." }];
const first = await client.chat.completions.create({
  model: "uncensored", messages, tools, tool_choice: "auto",
});

const msg = first.choices[0].message;
if (msg.tool_calls) {
  messages.push(msg);
  for (const call of msg.tool_calls) {
    const { sides } = JSON.parse(call.function.arguments);
    const result = 1 + Math.floor(Math.random() * sides);
    messages.push({ role: "tool", tool_call_id: call.id, content: String(result) });
  }
  const second = await client.chat.completions.create({ model: "uncensored", messages, tools });
  console.log(second.choices[0].message.content);
}

Selalu parse arguments di dalam blok try dalam kode nyata, karena model terkadang dapat mengembalikan JSON yang tidak valid. Untuk output terstruktur tanpa alat, atur response_format: { type: "json_object" } dan sebutkan JSON dalam prompt Anda. Adegan permainan yang memanggil fungsi dadu atau inventaris dibahas di membuat NPC game dan fiksi interaktif.

Tangani error dan batas laju

API mengembalikan HTTP 429 dalam tiga situasi. Kode error rate_limited berarti terlalu banyak permintaan per menit: 300 untuk kunci penuh, 60 untuk kunci uji coba. Kode concurrency berarti terlalu banyak sekaligus: 8 untuk kunci penuh, 2 untuk kunci uji coba. Saat kelebihan beban sementara, Anda juga mendapatkan 429 dengan header Retry-After: 5. SDK mengekspos status pada kesalahan yang dilempar, sehingga pembungkus kecil menangani ketiganya:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.unfilteredaiapi.com/v1",
  apiKey: process.env.AI_API_KEY,
});

const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

export async function chatWithRetry(params, tries = 4) {
  for (let i = 0; i < tries; i++) {
    try {
      return await client.chat.completions.create({ model: "uncensored", ...params });
    } catch (err) {
      if (err.status === 429 && i < tries - 1) {
        const wait = Number(err.headers?.["retry-after"]) || 2 ** i;
        await sleep(wait * 1000);
        continue;
      }
      throw err;
    }
  }
}

Pembungkus menunggu penundaan yang diminta server dan beralih ke mekanisme backoff eksponensial. Perhatikan bahwa paket OpenAI juga mencoba ulang beberapa kesalahan secara mandiri; atur maxRetries pada klien jika Anda ingin mengontrol ini. Status lain, seperti 401 untuk kunci yang salah, tidak boleh dicoba ulang. Tinjauan lebih mendalam tentang batas ada di FAQ.

Jalankan dan uji route

Mulai server dengan node server.js dan uji dari terminal kedua. Opsi -N mematikan buffering curl sehingga Anda melihat event tiba satu per satu:

# the server calls https://api.unfilteredaiapi.com/v1 with model uncensored
curl -N http://localhost:3000/chat   -H "Content-Type: application/json"   -d '{"messages":[{"role":"user","content":"Write a two-line riddle."}]}'

Di browser, baca stream dengan fetch dan pembaca, atau dengan pustaka helper SSE kecil. Karena route adalah POST, objek EventSource bawaan tidak cocok, jadi gunakan fetch dan dekode chunk sendiri.

Kebiasaan produksi

  • Simpan kunci dalam variabel lingkungan atau tempat penyimpanan rahasia, jangan di repositori.
  • Batasi body permintaan. API menerima hingga 8 MB, tetapi route Anda sendiri harus menerima jauh lebih sedikit.
  • Batasi riwayat yang Anda kirim. Potong putaran lama sebelum mereka menghabiskan uang Anda atau mengisi jendela 100.000 token.
  • Antrikan atau tolak pekerjaan tambahan saat Anda sudah memiliki 8 stream terbuka, alih-alih membiarkan API menjawab 429 kepada pengguna Anda.
  • Log header respons X-Request-Id, agar dukungan dapat melacak satu permintaan.

Periksa saldo dan biaya Anda

Setiap respons menyertakan header X-Balance-USD, dan GET /v1/balance mengembalikan saldo secara langsung. Harga adalah $0,15 per 1M token input dan $0,50 per 1M token output, yang dibebankan dari saldo prabayar, dan permintaan yang gagal atau ditolak gratis. Satu giliran chat dengan 800 token input dan 250 token output berharga $0,000245, sehingga 10.000 giliran berharga $2,45. Catat usage dari setiap respons dan Anda dapat memperkirakan tagihan Anda dalam beberapa sen. Halaman harga mencantumkan isi saldo mulai dari $20 hingga $500.

Tanya jawab

Paket npm mana yang harus saya gunakan?

Paket openai resmi berfungsi. Atur baseURL ke https://api.unfilteredaiapi.com/v1, masukkan kunci Anda, dan gunakan ID model uncensored.

Bisakah saya mengalirkan respons dari Node?

Ya. Berikan stream: true dan iterasi dengan for await. Tambahkan stream_options dengan include_usage untuk mendapatkan hitungan token di chunk terakhir.

Apakah API mendukung pemanggilan fungsi?

Ya. Kirim tools dan tool_choice, baca tool_calls dari balasan, dan kembalikan hasil sebagai pesan dengan role tool.

Apa yang harus dilakukan server saat HTTP 429?

Tunggu nilai Retry-After jika ada, jika tidak lakukan backoff eksponensial, lalu coba lagi beberapa kali. Kurangi permintaan paralel jika kode error adalah concurrency.

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.

Dapatkan kunci APIBaca dokumentasi