VI ▾
Nhận khóa API

Gọi API AI không kiểm duyệt lần đầu và kết nối SDK OpenAI

Nếu bạn là người mới dùng API AI không kiểm duyệt, bạn chỉ cần một khóa API và thay đổi base URL. Nếu bạn đã có mã viết bằng OpenAI SDK, bạn chỉ cần thay đổi địa chỉ và tên mô hình để nhận phản hồi đầu tiên.

Ngày cập nhật

Minh họa isometric về một connector tương thích OpenAI được cắm vào API gateway, dữ liệu đang chảy qua

Tóm tắt chính

  • base URL là https://api.mugeomyeolapi.com/v1, ID mô hình là uncensored.
  • Hỗ trợ các endpoint chat/completions, responses, models cùng với streaming, gọi hàm và chế độ JSON.
  • Lỗi 429 được chia thành hai loại: rate_limited và concurrency, mỗi loại có cách xử lý khác nhau tùy nguyên nhân.
  • Chỉ dành cho văn bản; nội dung liên quan đến tình dục có sự tham gia của người chưa thành niên không được phép trong mọi trường hợp.

Chuẩn bị trước khi bắt đầu

Bạn chỉ cần ba thứ: khóa, base URL và ID mô hình. Phần còn lại do trình khách tương thích OpenAI mà bạn thường dùng xử lý.

  1. Đăng ký. Bạn có thể đăng ký bằng tài khoản Google hoặc email và mật khẩu.
  2. Tạo khóa trên trang phát hành khóa API. Người dùng mới nhận $0,50 tín dụng dùng thử bằng một cú nhấn nút. Mỗi người 1 lần, hết hạn 7 ngày, không cần thanh toán.
  3. Đặt base URL là https://api.mugeomyeolapi.com/v1 và model là uncensored.

Xác thực dùng tiêu chuẩn Authorization: Bearer <key>. Đừng ghi khóa trực tiếp vào code, hãy dùng biến môi trường. Ví dụ dưới đều đọc biến MUGEOMYEOL_API_KEY.

Gọi lần đầu bằng Python

Sau khi cài đặt gói openai (v1+), bạn chỉ cần đổi base_url khi tạo client.

import os
from openai import OpenAI

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

res = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "당신은 간결하게 답하는 한국어 어시스턴트입니다."},
        {"role": "user", "content": "HTTP 429 오류가 무엇인지 두 문장으로 설명해 줘."},
    ],
    temperature=0.7,
)
print(res.choices[0].message.content)
print(res.usage)

usage trong phản hồi chứa số token đầu vào và đầu ra. Phí tính dựa trên số này. Số dư còn lại hiển thị ngay trong header X-Balance-USD. Với Python SDK, dùng with_raw_response để truy cập header.

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"])
raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "안녕"}],
)
print("잔액(USD):", raw.headers.get("X-Balance-USD"))
completion = raw.parse()
print(completion.choices[0].message.content)

Ví dụ curl và Node.js

Nếu bạn chỉ muốn kiểm tra mà không cần SDK, curl là nhanh nhất. Nó rất hữu ích để kiểm tra xem khóa có hoạt động đúng không.

curl https://api.mugeomyeolapi.com/v1/chat/completions \
  -H "Authorization: Bearer $MUGEOMYEOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "한 줄로 자기소개해 줘."}]
  }'

Cấu trúc trong Node.js cũng tương tự.

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "짧은 시를 한 편 써 줘." }],
  stream: true,
  stream_options: { include_usage: true },
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Bật streaming bằng stream: true và nhận qua SSE. Lượng token tiêu thụ hiển thị ở cuối stream. Danh sách model lấy qua GET /v1/models. Dịch vụ chỉ có model uncensored nên danh sách rất ngắn.

Các tham số thường dùng

Hầu hết các tham số được sử dụng trong OpenAI Chat Completions đều hoạt động nguyên vẹn. Tổng hợp những thứ thường dùng nhất như sau.

Tham sốMục đích
temperature, top_pĐiều chỉnh độ ngẫu nhiên của câu trả lời. Thay vì thay đổi cả hai cùng lúc với giá trị lớn, bạn nên chỉ điều chỉnh một cái để dễ dự đoán kết quả hơn.
stop, seedChỉ định chuỗi kết thúc, cố gắng đảm bảo khả năng tái tạo
presence/frequency penaltyỨc chế lặp lại
max_tokensTùy chọn. Nếu bỏ qua, bạn có thể sử dụng phần còn lại của cửa sổ ngữ cảnh.
tools, tool_choiceGọi hàm. Kết quả trả về dưới dạng message role: "tool".
response_formatBật chế độ JSON bằng {"type":"json_object"}.

Cửa sổ ngữ cảnh là 100.000 token cho cả prompt và đầu ra. Khi đưa tài liệu dài vào, hãy đảm bảo phần đầu vào không chiếm phần lớn giới hạn này. Khi dùng chế độ JSON, bạn nên ghi rõ trong prompt yêu cầu trả lời bằng JSON để đảm bảo tính ổn định.

import os, json
from openai import OpenAI

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

res = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[{"role": "user", "content": "도시 3곳의 이름과 인구 규모 느낌을 JSON 객체로 줘. 키는 cities 하나."}],
)
data = json.loads(res.choices[0].message.content)
print(data)

Endpoint không chỉ có POST /v1/chat/completions mà còn có POST /v1/responses. Nếu bạn đang viết mã mới sử dụng định dạng Responses, bạn có thể gọi chúng trên cùng một base URL. Các trường chi tiết có thể xem tại tài liệu API.

Mã lỗi và xử lý thử lại

Lỗi bạn sẽ gặp phải đầu tiên là HTTP 429. Trong dịch vụ này, lỗi này có hai ý nghĩa khác nhau.

  • rate_limited: Bạn đã vượt quá số lượng yêu cầu mỗi phút. Khóa chính cho phép 300 yêu cầu/phút, khóa dùng thử cho phép 60 yêu cầu/phút.
  • concurrency: Số lượng yêu cầu đang xử lý đồng thời quá nhiều. Khóa chính cho phép tối đa 8, khóa dùng thử cho phép tối đa 2.

Máy chủ cũng có thể trả về 429 khi tạm thời bận, kèm theo tiêu đề Retry-After: 5. Bạn chỉ cần gửi lại sau 5 giây. Hãy nhớ rằng yêu cầu streaming chiếm một khe xử lý đồng thời cho đến khi luồng kết thúc. Nếu bạn mở luồng mà không đóng, bạn sẽ nhanh chóng chạm giới hạn đồng thời.

import os, time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"], max_retries=0)

def ask(prompt, tries=5):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (i + 1))  # 5초, 10초, 15초 ... 점점 늘려 기다림
    raise RuntimeError("재시도 한도를 넘었습니다")

print(ask("테스트 메시지"))

Nếu số lượng yêu cầu đồng thời là vấn đề, việc hạn chế số lượng bằng semaphore phía gọi sẽ tốt hơn là thử lại. Bạn có thể kiểm tra giới hạn của khóa hiện tại thông qua các tiêu đề phản hồi X-RateLimit-Limit-Requests và X-RateLimit-Limit-Concurrency. Kích thước thân yêu cầu tối đa là 8MB. Các yêu cầu thất bại hoặc bị từ chối sẽ không bị tính phí. Khi báo cáo sự cố, hãy cung cấp X-Request-Id từ tiêu đề phản hồi để trang hỗ trợ dễ dàng xác định nguyên nhân hơn.

Quy tắc sử dụng và các giới hạn cần lưu ý

Dịch vụ này là một API do một nhà cung cấp độc lập vận hành, sử dụng một mô hình trọng số mở đã được tinh chỉnh để trả lời mà không từ chối nội dung, với giả định người dùng là người trưởng thành hợp pháp. Đây không phải là API chính thức của bất kỳ công ty nào như Meta, Mistral, Qwen, DeepSeek, OpenAI, xAI, Google hay Anthropic, và cũng không phải là bộ định tuyến phân phối yêu cầu giữa nhiều mô hình của các nhà cung cấp khác nhau. Khi chọn một API AI không kiểm duyệt, bạn cần hiểu rõ sự khác biệt này để không nhầm lẫn giữa tài liệu và hành vi thực tế.

  • Nội dung liên quan đến tình dục có sự tham gia của người chưa thành niên không được phép trong bất kỳ trường hợp nào. Giới hạn này không thể bỏ qua.
  • Chỉ hỗ trợ văn bản. Không cung cấp tạo ảnh, tạo giọng nói, tạo video, embedding hay fine-tuning.
  • Prompt bạn đưa vào sẽ không được dùng để huấn luyện mô hình. Để biết thêm chi tiết, vui lòng tham khảo chính sách quyền riêng tư.

Việc không có từ chối trong câu trả lời không có nghĩa là không có trách nhiệm. Bên cung cấp dịch vụ vẫn phải tuân thủ điều khoản sử dụng và các quy định pháp luật liên quan.

Cảm nhận về chi phí và nạp tiền

Giá là $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra, được trừ từ tín dụng trả trước. Không có gói đăng ký và tín dụng không bao giờ hết hạn. Ví dụ, một yêu cầu với 2.000 token đầu vào và 500 token đầu ra sẽ tốn $0,0003 cho đầu vào và $0,00025 cho đầu ra, tổng cộng $0,00055. Gửi 1.000 yêu cầu cũng chỉ tốn $0,55.

Bạn có thể thử khoảng 900 yêu cầu có quy mô như trên với $0,50 tín dụng dùng thử. Bạn có thể nạp tiền với số tiền nguyên từ $20 đến $500, kèm theo bonus 5% cho mức từ $50 trở lên, 10% cho mức từ $100 trở lên và 15% cho mức từ $200 trở lên. Phương thức thanh toán là USDT (TRC20) và USDC (Base). Bảng giá chi tiết có tại trang giá cả.

Hướng dẫn khác

Câu hỏi thường gặp

Tôi cần thay đổi mã SDK OpenAI bao nhiêu?

Bạn chỉ cần thay đổi ba thứ: base URL, khóa API và tên mô hình. ID mô hình là uncensored, base URL là https://api.mugeomyeolapi.com/v1.

Làm thế nào để nhận tín dụng dùng thử?

Sau khi đăng ký, bạn chỉ cần nhấn một lần vào nút trên trang khóa API để nhận $0,50. Mỗi người dùng 1 lần, thời hạn 7 ngày và không cần thông tin thanh toán.

Tôi gặp lỗi 429, phải làm sao?

Trước tiên, hãy xác định xem mã lỗi là rate_limited hay concurrency. Cái đầu tiên là vượt quá số lượng yêu cầu mỗi phút, cái thứ hai là vượt quá số lượng yêu cầu đồng thời. Nếu có tiêu đề Retry-After, hãy đợi khoảng thời gian đó rồi thử lại.

Tôi có thể tạo ảnh không?

Không. API này chỉ dành cho văn bản và không hỗ trợ tạo ảnh, tạo giọng nói, tạo video hay embedding.

Tôi có thể đưa tài liệu dài vào cùng một lúc không?

Bạn có thể sử dụng tối đa 100.000 token cho cả prompt và đầu ra. Kích thước thân yêu cầu tối đa là 8MB.

Khóa API chỉ cần đăng ký

Tạo tài khoản, sao chép khóa, thay đổi base URL. Cấu hình chỉ dừng lại ở đó.

Nhận khóa API
Nhận khóa API