TH ▾
รับคีย์ API

การเรียกใช้ AI API แบบไม่เซ็นเซอร์ครั้งแรกและการเชื่อมต่อ OpenAI SDK

หากคุณใช้ API AI ไม่เซ็นเซอร์เป็นครั้งแรก สิ่งที่คุณต้องมีคือคีย์ API และการเปลี่ยน base URL เพียงอย่างเดียว หากมีโค้ดที่เขียนด้วย OpenAI SDK อยู่แล้ว คุณสามารถรับคำตอบแรกได้เพียงเปลี่ยนที่อยู่และชื่อโมเดล

วันที่อัปเดต

ภาพประกอบไอโซเมตริกแสดงคอนเนกเตอร์ที่เข้ากันได้กับ OpenAI เสียบอยู่ใน API เกตเวย์ที่มีข้อมูลไหลผ่าน

สรุปสำคัญ

  • Base URL คือ https://api.mugeomyeolapi.com/v1, Model ID คือ uncensored เพียงตัวเดียว
  • รองรับเอนด์พอยต์ chat/completions, responses, models พร้อมสตรีมมิง การเรียกใช้ฟังก์ชัน และโหมด JSON
  • ข้อผิดพลาด 429 แบ่งเป็น rate_limited และ concurrency ซึ่งต้องจัดการต่างกันตามสาเหตุ
  • รองรับเฉพาะข้อความ และเนื้อหาทางเพศที่มีผู้เยาว์เกี่ยวข้องจะไม่อนุญาตในทุกรูปแบบ

สิ่งที่ต้องเตรียมก่อนเริ่ม

มีเพียงสามสิ่งที่ต้องเตรียม คือ คีย์ API, base URL และ model ID ส่วนที่เหลือคอนเนกเตอร์ที่เข้ากันได้กับ OpenAI ที่คุณใช้งานปกติจะจัดการให้

  1. สมัครสมาชิก สามารถสมัครด้วยบัญชี Google หรืออีเมลและรหัสผ่าน
  2. สร้างคีย์ที่หน้าจัดการคีย์ API ผู้ใช้รายใหม่สามารถรับเครดิตทดลองใช้ฟรีมูลค่า $0.50 ได้เพียงคลิกปุ่มเดียวบนหน้านี้ โดยจำกัดเพียง 1 ครั้งต่อ 1 คน ระยะเวลาใช้งาน 7 วัน และไม่จำเป็นต้องใส่ข้อมูลการชำระเงิน
  3. กำหนด base URL เป็น https://api.mugeomyeolapi.com/v1 และกำหนด model เป็น uncensored

การตรวจสอบสิทธิ์ใช้หัวข้อความมาตรฐาน Authorization: Bearer <key> โดยคีย์ควรเก็บไว้ในตัวแปรสภาพแวดล้อมแทนที่จะใส่ลงในโค้ดโดยตรง ตัวอย่างด้านล่างทั้งหมดอ่านตัวแปร MUGEOMYEOL_API_KEY

การเรียกใช้ครั้งแรกด้วย Python

หลังจากติดตั้งแพ็กเกจ openai (เวอร์ชัน 1 ขึ้นไป) เพียงเปลี่ยนค่า base_url เมื่อสร้างไคลเอนต์

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 ในคำตอบมีจำนวนโทเคนอินพุตและเอาต์พุต ค่าบริการคำนวณจากตัวเลขนี้ สามารถดูยอดคงเหลือที่เหลือได้จาก header ของ response X-Balance-USD โดยตรง ใน Python SDK สามารถเข้าถึง header ได้โดยใช้ with_raw_response

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)

ตัวอย่าง curl และ Node.js

หากต้องการตรวจสอบโดยไม่ใช้ SDK curl เป็นวิธีที่เร็วที่สุด มีประโยชน์เมื่อตรวจสอบว่าคีย์ทำงานได้ถูกต้องหรือไม่

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": "한 줄로 자기소개해 줘."}]
  }'

โครงสร้างใน Node.js ก็เหมือนกัน

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 ?? "");
}

สตรีมมิงเปิดใช้งานด้วย stream: true เพียงค่าเดียวและส่งผ่าน SSE สามารถตรวจสอบการใช้งานได้ที่จุดสิ้นสุดสตรีม ดูรายชื่อโมเดลที่ใช้ได้ผ่าน GET /v1/models บริการนี้มีเพียงโมเดล uncensored ทำให้รายการโมเดลสั้น

พารามิเตอร์ที่พบบ่อย

พารามิเตอร์ที่ใช้ใน OpenAI Chat Completions ส่วนใหญ่ใช้งานได้เหมือนเดิม สรุปเฉพาะพารามิเตอร์ที่พบบ่อยมีดังนี้

พารามิเตอร์วัตถุประสงค์
temperature, top_pควบคุมความสุ่มของคำตอบ การปรับเพียงค่าเดียวจะช่วยให้คาดเดาผลลัพธ์ได้ง่ายกว่าการปรับทั้งสองค่าให้มากพร้อมกัน
stop, seedระบุสตริงหยุด, พยายามรับประกันความสามารถในการสร้างซ้ำ
การปรับค่าความถี่/การปรากฏการยับยั้งการซ้ำ
max_tokensไม่บังคับ หากละเว้นสามารถใช้งานพื้นที่ที่เหลือของหน้าต่างบริบทได้
tools, tool_choiceการเรียกใช้ฟังก์ชัน ผลลัพธ์ส่งกลับผ่านข้อความ role: "tool"
response_formatเปิดโหมด JSON ด้วย {"type":"json_object"}

หน้าต่างบริบทมีขนาด 100,000 โทเคน รวมพรอมต์และเอาต์พุต เมื่อใส่เอกสารยาว ตรวจสอบให้แน่ใจว่าอินพุตไม่กินพื้นที่ส่วนใหญ่ของขีดจำกัดนี้ เมื่อใช้โหมด JSON จะมีความเสถียรมากขึ้นหากเขียนพรอมต์ให้ตอบกลับเป็น JSON

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)

นอกจากเอนด์พอยต์ POST /v1/chat/completions แล้ว ยังมี POST /v1/responses ด้วย หากโค้ดใหม่ใช้รูปแบบ Responses สามารถเรียกใช้ผ่าน base URL เดียวกันได้ ดูรายละเอียดฟิลด์เพิ่มเติมใน เอกสาร API

รหัสข้อผิดพลาดและการจัดการการลองใหม่

ข้อผิดพลาดที่พบบ่อยที่สุดคือ HTTP 429 ในบริการนี้มีความหมายสองแบบ

  • rate_limited: เกินจำนวนคำขอต่อนาที คีย์ปกติอนุญาต 300 คำขอต่อนาที คีย์ทดลองอนุญาต 60 คำขอต่อนาที
  • concurrency: มีคำขอที่กำลังดำเนินการอยู่พร้อมกันมากเกินไป คีย์ปกติรองรับ 8 คำขอ คีย์ทดลองรองรับ 2 คำขอ

แม้เซิร์ฟเวอร์จะทำงานหนักชั่วคราว ก็อาจส่ง 429 มาได้ ซึ่งจะมี Retry-After: 5 ในส่วนหัวแนบมาด้วย รอ 5 วินาทีแล้วส่งใหม่ก็ได้ สำหรับการสตรีมมิง โปรดจำไว้ว่าคำขอสตรีมมิงจะกินช่อง concurrent หนึ่งช่องจนกว่าสตรีมจะจบ หากเปิดสตรีมไว้แล้วไม่ปิด จะถึงขีดจำกัด concurrent ได้เร็ว

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("테스트 메시지"))

หากคำขอพร้อมกันเป็นปัญหา การจำกัดจำนวนคำขอพร้อมกันด้วย semaphore ในฝั่งการเรียกใช้จะดีกว่าการลองใหม่ สามารถตรวจสอบขีดจำกัดของคีย์ปัจจุบันผ่าน header X-RateLimit-Limit-Requests และ X-RateLimit-Limit-Concurrency ได้ ขนาดคำขอสูงสุด 8 MB คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่คิดเงิน เมื่อสอบถามปัญหา โปรดส่ง X-Request-Id จาก header ของ response มาด้วย จะช่วยให้หาสาเหตุได้ง่ายขึ้นที่ หน้าสนับสนุน

กฎการใช้งานและขีดจำกัดที่ควรทราบ

บริการนี้คือ API ที่ผู้ประกอบการรายเดียวดำเนินการ โดยใช้โมเดล open-weight model ที่ปรับให้ตอบโดยไม่ปฏิเสธเนื้อหา โดยตั้งสมมติฐานว่าผู้ใช้เป็นผู้ใหญ่ ไม่ใช่ API ทางการของบริษัทใด ๆ เช่น Meta, Mistral, Qwen, DeepSeek, OpenAI, xAI, Google, Anthropic และไม่ใช่ router ที่กระจายคำขอไปยังโมเดลของบริษัทอื่น ๆ เมื่อเลือก API AI uncensored ต้องรู้ความแตกต่างนี้ เพื่อไม่ให้สับสนระหว่างเอกสารกับการทำงานจริง

  • เนื้อหาทางเพศที่มีผู้เยาว์เกี่ยวข้อง จะไม่อนุญาตในกรณีใด ๆ ขีดจำกัดนี้ไม่สามารถยกเว้นได้
  • รองรับเฉพาะข้อความ ไม่รองรับการสร้างภาพ เสียง วิดีโอ การสร้างเอนเบดดิ้ง และการฟاینทูนิง
  • prompt ที่คุณป้อนจะไม่ถูกนำไปใช้ในการฝึกโมเดล ดูรายละเอียดเพิ่มเติมได้ที่ นโยบายความเป็นส่วนตัว

การไม่ปฏิเสธคำตอบไม่ได้หมายความว่าไม่มีภาระรับผิดชอบ ผู้ให้บริการต้องปฏิบัติตามข้อกำหนดการให้บริการและกฎหมายที่เกี่ยวข้อง

ความรู้สึกเกี่ยวกับต้นทุนและการเติมเงิน

ราคาคือ $0.15 ต่อ 1 ล้านโทเคนสำหรับ input และ $0.50 ต่อ 1 ล้านโทเคนสำหรับ output ซึ่งจะถูกหักจากเครดิตแบบเติมเงินล่วงหน้า ไม่มีระบบสมัครสมาชิก และเครดิตไม่หมดอายุ ตัวอย่างเช่น คำขอหนึ่งที่มี input 2,000 โทเคน และ output 500 โทเคน จะคิดเงิน input $0.0003 และ output $0.00025 รวมเป็น $0.00055 หากส่ง 1,000 คำขอ จะคิดเงิน $0.55

คุณสามารถทดสอบคำขอขนาดดังกล่าวได้ประมาณ 900 คำขอด้วยเครดิตทดลองใช้ $0.50 การเติมเงินสามารถทำได้เป็นจำนวนเต็มตั้งแต่ $20 ถึง $500 พร้อมโบนัส 5% สำหรับยอด $50 ขึ้นไป 10% สำหรับยอด $100 ขึ้นไป และ 15% สำหรับยอด $200 ขึ้นไป ช่องทางชำระเงินคือ USDT (TRC20) และ USDC (Base) ตารางรายละเอียดราคาอยู่ที่ หน้าอัตราค่าบริการ

คู่มือเพิ่มเติม

คำถามที่พบบ่อย

ต้องแก้ไขโค้ด OpenAI SDK มากน้อยเพียงใด?

คุณเพียงต้องเปลี่ยนสามสิ่งนี้: base URL, API key และชื่อโมเดล โดย model ID คือ uncensored และ base URL คือ https://api.mugeomyeolapi.com/v1.

รับเครดิตทดลองใช้ได้อย่างไร?

หลังจากสมัคร ให้กดปุ่มหนึ่งครั้งในหน้า API key เพื่อรับเครดิต $0.50 ให้สิทธิ์ครั้งเดียวต่อผู้ใช้ 1 คน มีอายุการใช้งาน 7 วัน และไม่จำเป็นต้องใส่ข้อมูลการชำระเงิน

เกิดข้อผิดพลาด 429 ต้องทำอย่างไร?

ก่อนอื่นให้ตรวจสอบว่า error code เป็น rate_limited หรือ concurrency โดยแบบแรกคือเกินจำนวนคำขอต่อนาที และแบบที่สองคือเกินจำนวน parallel requests หากมี header Retry-After ให้รอตามเวลาที่ระบุแล้วลองใหม่

สามารถสร้างภาพได้หรือไม่?

ไม่ได้ API นี้รองรับเฉพาะข้อความ และไม่รองรับการสร้างภาพ เสียง วิดีโอ หรือ embedding

สามารถใส่เอกสารยาวๆ ได้พร้อมกันหรือไม่?

สามารถใช้งานรวมพรอมต์และผลลัพธ์ได้สูงสุด 100,000 โทเคน ขนาดเนื้อหาคำขอสูงสุด 8 MB

คีย์ API เพียงแค่สมัคร

สร้างบัญชี คัดลอกคีย์ เปลี่ยน Base URL การตั้งค่าเสร็จเพียงเท่านี้

รับคีย์ API
รับคีย์ API