VI ▾
Base URL https://api.uncensoredaiapis.com/v1Mô hình uncensored
Lấy khóa API
Uncensored AIVí dụ mã

Ví dụ mã API Uncensored AI bằng Python, Node.js và cURL

Trang này tổng hợp các đoạn mã sao chép và dán cho API AI không kiểm duyệt, sử dụng định dạng chat completions của OpenAI. Bạn sẽ tìm thấy các lệnh gọi đầu tiên bằng Python, Node.js và cURL, truyền phát với SDK và với raw fetch, gọi hàm, logic xử lý lại cho 429 và 503, trạng thái đa lượt, và kiểm soát chi phí với max_tokens.

Ví dụ mã API Uncensored AI bằng Python, Node.js và cURL

Cập nhật

Điểm chính

  • Sử dụng SDK openai chính thức với base_url được đặt thành https://api.uncensoredaiapis.com/v1 và mô hình "uncensored"; không cần client tùy chỉnh.
  • Truyền phát trả về các chunk SSE, và một chunk usage cuối cùng sẽ tự động đến với danh sách choices rỗng.
  • Chỉ xử lý lại 429 và 503 (upstream_busy); 400, 401, 402 và 403 cần được sửa chữa, không phải xử lý lại.
  • API không có trạng thái: gửi lại lịch sử ở mỗi lượt, và giới hạn đầu ra bằng max_tokens (tùy chọn; nếu không đặt, phản hồi có thể chạy đến hết cửa sổ ngữ cảnh).

Lệnh gọi đầu tiên: Python, Node.js và cURL

Các ví dụ sử dụng https://api.uncensoredaiapis.com/v1, model uncensored, và POST /v1/chat/completions hoặc GET /v1/models. Gửi khóa hiện tại của bạn trong header Authorization: Bearer <key>. Nếu cần, tạo tài khoản, yêu cầu tín dụng dùng thử đủ điều kiện và kiểm tra số dư hiển thị đã sẵn sàng trước khi gửi yêu cầu.

Các ví dụ đọc khóa từ biến môi trường có tên API_KEY. Bạn chỉ cần xuất nó một lần trong shell của mình và không cần chỉnh sửa bất kỳ đoạn mã nào. Không bao giờ dán khóa vào mã nguồn hoặc gửi nó trong JavaScript trình duyệt; hãy gọi API từ backend của bạn.

export API_KEY="paste-your-key-here"

Python, sử dụng gói openai chính thức (v1 trở lên). Sự khác biệt duy nhất so với thiết lập OpenAI tiêu chuẩn là base_url và tên mô hình.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a two-line villain monologue."}],
    max_tokens=200,
)
print(resp.choices[0].message.content)
print(resp.usage)

Node.js, sử dụng gói npm openai (v4 trở lên) dưới dạng ES module.

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a two-line villain monologue." }],
  max_tokens: 200,
});
console.log(resp.choices[0].message.content);
console.log(resp.usage);

Và cURL thuần túy, đây là cách nhanh nhất để kiểm tra xem khóa có hoạt động không:

curl https://api.uncensoredaiapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a two-line villain monologue."}],
    "max_tokens": 200
  }'

Phản hồi có cấu trúc OpenAI thông thường: choices[0].message.content cho văn bản và đối tượng usage với số lượng token prompt và completion, bạn có thể nhân chúng với giá trên mỗi token để theo dõi chi tiêu. Xem tài liệu để có danh sách đầy đủ các tham số.

Truyền phát (SSE) với SDK

Đặt stream: true và API trả về các sự kiện gửi bởi máy chủ thay vì một thân JSON duy nhất. Cả hai SDK chính thức đều chuyển đổi điều đó thành một bộ lặp, vì vậy mã của bạn sẽ lặp qua các chunk và in từng delta. Một chunk cuối cùng mang usage token sẽ được thêm tự động; bạn không cần phải yêu cầu nó. Chunk này có danh sách choices rỗng, vì vậy hãy bảo vệ chỉ mục trước khi đọc nó.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Describe a rainy harbor town in 120 words."}],
    max_tokens=300,
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print("\n\nusage:", chunk.usage)

Phiên bản Node.js sử dụng for await:

import OpenAI from "openai";

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

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

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

Truyền phát không thay đổi giá. Bạn trả tiền cho cùng số lượng token đầu vào và đầu ra; bạn chỉ thấy các từ đầu tiên sớm hơn, điều này quan trọng đối với các giao diện trò chuyện và nhập vai nơi việc chờ đợi một phản hồi đầy đủ 500 token cảm thấy chậm.

Truyền phát với raw fetch

Nếu bạn muốn không phụ thuộc vào SDK, ví dụ trong một hàm edge hoặc một tập lệnh nhỏ, bạn có thể tự đọc luồng. Định dạng dây là SSE thuần túy: mỗi sự kiện là một dòng bắt đầu bằng data: theo sau là một chunk JSON, và các sự kiện được phân tách bằng các dòng trống. Các chunk mạng không khớp với ranh giới sự kiện, vì vậy bạn phải đệm và chia nhỏ theo dấu xuống dòng. Ví dụ dưới đây chạy trên Node 18 trở lên (lưu nó dưới dạng stream.mjs) và cũng hoạt động trong bất kỳ môi trường chạy nào có fetch và ReadableStream tiêu chuẩn.

const res = await fetch("https://api.uncensoredaiapis.com/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "uncensored",
    messages: [{ role: "user", content: "Tell a 100-word ghost story." }],
    max_tokens: 250,
    stream: true,
  }),
});

if (!res.ok) {
  throw new Error(`HTTP ${res.status}: ${await res.text()}`);
}

const decoder = new TextDecoder();
let buffer = "";

for await (const bytes of res.body) {
  buffer += decoder.decode(bytes, { stream: true });
  const lines = buffer.split("\n");
  buffer = lines.pop(); // keep the incomplete tail for the next round

  for (const line of lines) {
    if (!line.startsWith("data:")) continue;
    const data = line.slice(5).trim();
    if (data === "[DONE]") continue;
    const chunk = JSON.parse(data);
    const text = chunk.choices?.[0]?.delta?.content;
    if (text) process.stdout.write(text);
    if (chunk.usage) console.log("\n\nusage:", chunk.usage);
  }
}

Bạn kiểm tra res.ok trước khi bắt đầu đọc. Lỗi như 401, 402 hoặc 403 xuất hiện dưới dạng một đối tượng JSON chuẩn với đối tượng error, không phải luồng sự kiện, vì vậy việc phân tích chúng dưới dạng SSE sẽ không tạo ra kết quả nào. Trong trình duyệt, bạn có thể sử dụng cùng logic đó với res.body.getReader(), nhưng hãy nhớ rằng trình duyệt phải gọi backend của bạn, không gọi trực tiếp API này với khóa bí mật.

Gọi hàm với công cụ và tool_choice

Gọi công cụ sử dụng định dạng OpenAI. Bạn mô tả các hàm trong tools, mô hình trả lời bằng tool_calls thay vì văn bản khi nó muốn chạy một hàm, bạn tự thực hiện hàm đó và gửi kết quả lại dưới dạng một tin nhắn với role: "tool" và tool_call_id tương ứng. Một yêu cầu thứ hai sau đó sẽ trả về câu trả lời cuối cùng bằng ngôn ngữ tự nhiên. tool_choice kiểm soát hành vi: "auto" cho phép mô hình quyết định, "none" cấm các công cụ, và một đối tượng như {"type": "function", "function": {"name": "get_order_status"}} bắt buộc thực hiện hàm đó.

import json
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)

def get_order_status(order_id: str) -> dict:
    # Replace with a real lookup.
    return {"order_id": order_id, "status": "shipped", "eta_days": 2}

tools = [{
    "type": "function",
    "function": {
        "name": "get_order_status",
        "description": "Look up the shipping status of an order by its id.",
        "parameters": {
            "type": "object",
            "properties": {"order_id": {"type": "string"}},
            "required": ["order_id"],
        },
    },
}]

messages = [{"role": "user", "content": "Where is order A-1042?"}]

first = client.chat.completions.create(
    model="uncensored",
    messages=messages,
    tools=tools,
    tool_choice="auto",
    max_tokens=500,
)
msg = first.choices[0].message

if msg.tool_calls:
    messages.append(msg)  # keep the assistant turn that contains tool_calls
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        result = get_order_status(**args)
        messages.append({
            "role": "tool",
            "tool_call_id": call.id,
            "content": json.dumps(result),
        })
    final = client.chat.completions.create(
        model="uncensored",
        messages=messages,
        tools=tools,
        max_tokens=500,
    )
    print(final.choices[0].message.content)
else:
    print(msg.content)

Vòng lặp tương tự trong Node.js:

import OpenAI from "openai";

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

const getOrderStatus = ({ order_id }) => ({ order_id, status: "shipped", eta_days: 2 });

const tools = [{
  type: "function",
  function: {
    name: "get_order_status",
    description: "Look up the shipping status of an order by its id.",
    parameters: {
      type: "object",
      properties: { order_id: { type: "string" } },
      required: ["order_id"],
    },
  },
}];

const messages = [{ role: "user", content: "Where is order A-1042?" }];

const first = await client.chat.completions.create({
  model: "uncensored", messages, tools, tool_choice: "auto", max_tokens: 500,
});
const msg = first.choices[0].message;

if (msg.tool_calls?.length) {
  messages.push(msg);
  for (const call of msg.tool_calls) {
    const result = getOrderStatus(JSON.parse(call.function.arguments));
    messages.push({ role: "tool", tool_call_id: call.id, content: JSON.stringify(result) });
  }
  const final = await client.chat.completions.create({
    model: "uncensored", messages, tools, max_tokens: 500,
  });
  console.log(final.choices[0].message.content);
} else {
  console.log(msg.content);
}

Hai ghi chú thực tế. Thứ nhất, arguments là một chuỗi JSON được tạo bởi mô hình ngôn ngữ, vì vậy hãy luôn bọc json.loads trong xử lý lỗi trong sản xuất và xác thực các trường trước khi chạm vào cơ sở dữ liệu. Thứ hai, các định nghĩa công cụ tính là token đầu vào trên mọi yêu cầu, vì vậy hãy giữ mô tả ngắn gọn và chỉ gửi các công cụ liên quan đến bước hiện tại.

Xử lý lại với độ trễ tăng dần trên 429 và 503

Hai lỗi đáng để xử lý lại. Một 429 có nghĩa là bạn đã vượt quá giới hạn 300 yêu cầu mỗi phút cho khóa của bạn. Một 503 với mã upstream_busy có nghĩa là dịch vụ đang bị quá tải tạm thời; chờ đợi vài giây là phản hồi dự kiến. Không xử lý lại 400 (sửa yêu cầu), 401 (sửa khóa), 402 no_credit (nạp tiền vào số dư), hoặc 403 content_blocked (yêu cầu sẽ bị chặn lại). Lỗi chia sẻ một hình dạng JSON duy nhất, {"error":{"code":...,"message":...}}, vì vậy bạn có thể ghi lại mã trực tiếp.

Các SDK OpenAI đã xử lý lại các lỗi kết nối, 429 và 5xx một vài lần theo mặc định, và bạn có thể tăng điều đó bằng max_retries. Nếu bạn muốn kiểm soát độ trễ, hãy tắt các xử lý lại tích hợp và bao bọc lệnh gọi của riêng bạn, sử dụng độ trễ tăng dần có nhiễu để các worker song song không xử lý lại cùng lúc.

import os
import random
import time
from openai import OpenAI, APIStatusError, APIConnectionError

client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
    max_retries=0,  # we handle retries ourselves
)

RETRYABLE = {429, 503}

def chat_with_retry(messages, max_attempts=5, **kwargs):
    for attempt in range(max_attempts):
        try:
            return client.chat.completions.create(
                model="uncensored", messages=messages, **kwargs
            )
        except APIStatusError as e:
            if e.status_code not in RETRYABLE or attempt == max_attempts - 1:
                raise
        except APIConnectionError:
            if attempt == max_attempts - 1:
                raise
        delay = min(30, 2 ** attempt) + random.uniform(0, 1)
        time.sleep(delay)

resp = chat_with_retry(
    [{"role": "user", "content": "Give me three names for a tavern."}],
    max_tokens=100,
)
print(resp.choices[0].message.content)

Bản tương đương với raw fetch trong Node.js:

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

async function chatWithRetry(body, maxAttempts = 5) {
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    const res = await fetch("https://api.uncensoredaiapis.com/v1/chat/completions", {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${process.env.API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ model: "uncensored", ...body }),
    });

    if (res.ok) return res.json();

    const retryable = res.status === 429 || res.status === 503;
    if (!retryable || attempt === maxAttempts - 1) {
      throw new Error(`HTTP ${res.status}: ${await res.text()}`);
    }
    const delay = Math.min(30000, 2 ** attempt * 1000) + Math.random() * 1000;
    await sleep(delay);
  }
}

const data = await chatWithRetry({
  messages: [{ role: "user", content: "Give me three names for a tavern." }],
  max_tokens: 100,
});
console.log(data.choices[0].message.content);

Nếu bạn thường xuyên gặp 429, giải pháp tốt hơn thường là giới hạn độ đồng thời phía máy khách nhỏ (một semaphore hoặc một hàng đợi với năm đến mười worker) thay vì ngủ lâu hơn. Ở mức 300 yêu cầu mỗi phút, bạn có thể duy trì năm yêu cầu mỗi giây, điều này là đủ cho hầu hết các ứng dụng.

Trạng thái hội thoại đa lượt

API không có trạng thái. Nó không nhớ các yêu cầu trước đó, vì vậy mọi lệnh gọi phải bao gồm lịch sử mà bạn muốn mô hình xem. Hãy giữ một danh sách các tin nhắn, thêm lượt người dùng, gọi API, thêm phản hồi trợ lý và lặp lại. Một tin nhắn hệ thống ở chỉ mục 0 giữ nhân vật hoặc hướng dẫn và được gửi mỗi lần.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)

messages = [
    {"role": "system", "content": "You are a dry-witted ship's AI. Keep replies under 80 words."}
]

def say(text: str) -> str:
    messages.append({"role": "user", "content": text})
    resp = client.chat.completions.create(
        model="uncensored", messages=messages, max_tokens=300
    )
    reply = resp.choices[0].message.content
    messages.append({"role": "assistant", "content": reply})
    return reply

print(say("We just lost the main engine. Options?"))
print(say("Which of those is the least risky?"))

Vì toàn bộ lịch sử được gửi lại, chi phí đầu vào tăng lên theo mỗi lượt. Cửa sổ ngữ cảnh là 100,000 token và bao gồm cả prompt và completion cộng lại, vì vậy khi một phiên rất dài khiến prompt + max_tokens vượt quá giới hạn, phản hồi sẽ dừng ở cuối cửa sổ; lỗi 400 chỉ xảy ra khi bản thân prompt dài hơn cửa sổ. Các chiến lược phổ biến là loại bỏ các cặp người dùng và trợ lý cũ nhất trong khi luôn giữ tin nhắn hệ thống, hoặc yêu cầu mô hình tóm tắt các lượt cũ thành một tin nhắn ngắn và thay thế chúng. Lưu trữ lịch sử trong cơ sở dữ liệu của riêng bạn được đánh dấu bằng id hội thoại để một lần khởi động lại không làm mất luồng. Để biết các ví dụ về các phiên dài với ước tính chi phí thực tế, hãy xem trang trường hợp sử dụng.

Kiểm soát chi phí với max_tokens

Giá là $0.15 cho mỗi triệu token đầu vào và $0.50 cho mỗi triệu token đầu ra, được tính từ số dư trả trước. Đầu ra đắt gấp khoảng 3,3 lần đầu vào, và max_tokens là một giới hạn tùy chọn trên đầu ra cho một yêu cầu đơn lẻ. Nếu bạn không đặt nó, phản hồi có thể chạy đến hết cửa sổ ngữ cảnh. Đặt nó một cách có chủ đích là cách kiểm soát chi phí đơn giản nhất mà bạn có.

Phép tính trường hợp xấu nhất giúp ích. Nếu bạn không giới hạn đầu ra, một phản hồi có thể chạy đến hết cửa sổ ngữ cảnh, vì vậy chỉ riêng đầu ra có thể tốn tới 100,000 × $0.50 / 1,000,000 = $0.05. Nếu bạn đặt max_tokens thành 300 cho một phản hồi trò chuyện, trường hợp xấu nhất giảm xuống còn $0.00015. Một lượt điển hình với 1,500 token đầu vào và 300 token đầu ra tốn khoảng $0.000225 cộng thêm $0.00015, tức là dưới $0.001.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)

INPUT_PER_M = 0.25
OUTPUT_PER_M = 1.00

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise the plot of Hamlet in 5 sentences."}],
    max_tokens=250,
)

u = resp.usage
cost = u.prompt_tokens * INPUT_PER_M / 1_000_000 + u.completion_tokens * OUTPUT_PER_M / 1_000_000
print(f"in={u.prompt_tokens} out={u.completion_tokens} cost=${cost:.6f}")
print("finish_reason:", resp.choices[0].finish_reason)

Theo dõi finish_reason. Giá trị length có nghĩa là phản hồi đã đạt giới hạn của bạn và bị cắt; nếu điều đó xảy ra thường xuyên, hãy tăng giới hạn hoặc yêu cầu đầu ra ngắn hơn trong prompt, vì một giới hạn duy nhất chỉ cắt ngắn chứ không làm cho mô hình súc tích. Kết hợp giới hạn với các hướng dẫn như số từ mục tiêu, và ghi lại usage cho mọi lệnh gọi để bạn có thể xem các trung bình thực tế thay vì đoán. Tín dụng dùng thử miễn phí và chi tiết số dư của bạn có trên trang giá cả.

Hỏi đáp

Bạn có cần SDK đặc biệt cho API AI không kiểm duyệt này không?

Không. Gói Python openai chính thức (v1+) và gói npm openai (v4+) đều hoạt động. Bạn chỉ cần đặt base_url thành https://api.uncensoredaiapis.com/v1, truyền khóa của bạn và sử dụng id mô hình là uncensored.

Truyền phát (streaming) có bao gồm thông tin sử dụng token không?

Có. Với stream: true, API thêm một chunk cuối cùng mang số liệu sử dụng tự động. Chunk đó có mảng choices rỗng, vì vậy bạn hãy kiểm tra xem choices có tồn tại trước khi đọc delta.

Lỗi nào mà mã nguồn của bạn nên thử lại?

Xử lý lại khi 429 (giới hạn tốc độ, 300 yêu cầu mỗi phút trên mỗi khóa) và 503 upstream_busy bằng cách tăng dần độ trễ có nhiễu. Không xử lý lại 400, 401, 402 hoặc 403 vì yêu cầu đó sẽ tiếp tục thất bại.

Lịch sử hội thoại có được lưu trữ cho bạn giữa các lần gọi không?

Không. Mỗi yêu cầu là độc lập, vì vậy bạn gửi danh sách messages đầy đủ mỗi lần. Cửa sổ ngữ cảnh là 100.000 token cho prompt và completion kết hợp.

Khóa của bạn chỉ cách một biểu mẫu

Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.