คีย์ API Character AI: วิธีรับและใช้งาน
หากคุณกำลังค้นหาคีย์ API ของ Character AI สิ่งแรกที่ต้องรู้คือเว็บไซต์นี้ไม่ใช่ Character.ai และไม่ออกคีย์ให้ แต่คุณจะได้รับคีย์สำหรับ API ข้อความที่เข้ากันได้กับ OpenAI ซึ่งทำงานเป็นแบ็กเอนด์แบบแทนที่ได้ทันทีสำหรับแอปแชทตัวละคร
อัปเดต

ประเด็นสำคัญ
- คุณจะได้รับคีย์หลังจากสมัครสมาชิกด้วย Google หรืออีเมลและรหัสผ่าน จากนั้นเปิดหน้าคีย์ API
- ผู้ใช้ใหม่สามารถรับเครดิตทดลอง $0.50 ได้ด้วยการคลิกหนึ่งครั้ง ไม่ต้องใช้บัตร และใช้ได้เป็นเวลา 7 วัน
- ใช้ Base URL https://api.characteraiapi.com/v1 และ model ID
uncensoredกับ SDK ของ OpenAI ใดๆ ก็ได้ - เก็บคีย์ไว้บนเซิร์ฟเวอร์หรือในตัวแปรสภาพแวดล้อม ห้ามใส่ไว้ในโค้ดฝั่งหน้าเว็บที่เปิดเผยต่อสาธารณะ
สิ่งที่คุณจะได้รับจริงๆ
Character.ai เป็นผลิตภัณฑ์แชทสำหรับผู้บริโภค ผู้ที่ค้นหา คีย์ API ของ Character AI มักต้องการสิ่งใดสิ่งหนึ่ง: วิธีเรียกใช้แชทบอทตัวละครจากโค้ดของคุณเอง หรือแบ็กเอนด์สำหรับแอปเพอร์โซนาที่ไม่ถูกจำกัดด้วยกฎของผลิตภัณฑ์ที่โฮสต์ไว้ เว็บไซต์นี้ตอบโจทย์ความต้องการหลัง คุณเข้าสู่ระบบ รับคีย์ และส่งคำขอไปยังเอนด์พอยต์ที่เข้ากันได้กับ OpenAI ไม่มีอะไรที่นี่เชื่อมต่อกับ Character.ai หรือใช้ตัวละครของมัน
บริการนี้เป็น API ข้อความที่โฮสต์ไว้เบื้องหน้าโมเดลแบบ open-weight หนึ่งโมเดล ซึ่งดำเนินการโดยผู้ให้บริการอิสระและปรับแต่งให้ตอบโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย ไม่ใช่ API ทางการของผู้ขายโมเดลรายใดรายหนึ่ง และไม่ใช่ตัวกระจายการรับส่งข้ามผู้ขายหลายราย model ID คือ uncensored และ Base URL คือ https://api.characteraiapi.com/v1 มีสองวิธี: POST /v1/chat/completions และ GET /v1/models
เนื่องจากอินเทอร์เฟซตรงกับของ OpenAI งานในการสร้างตัวละครจึงอยู่ฝั่งของคุณ คุณเขียนบุคลิกภาพเป็น system message เก็บประวัติการสนทนา และส่งไปกับแต่ละคำขอ สิ่งนี้ให้คุณควบคุมเสียง ความจำ และจังหวะการสนทนาที่ผลิตภัณฑ์แบบปิดมักไม่เปิดเผย ขีดจำกัดที่เข้มงวดมีเท่ากันสำหรับผู้ใช้ทุกคน: ไม่มีเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ โดยเด็ดขาด
รับคีย์ของคุณในห้าขั้นตอน
เส้นทางทั้งหมดใช้เวลาเพียงไม่กี่นาที คุณไม่จำเป็นต้องใช้บัตรเพื่อเริ่มต้น
- สมัครสมาชิก ใช้ Google หรือลงทะเบียนด้วยอีเมลและรหัสผ่าน
- เปิดหน้าคีย์ ไปที่ หน้าคีย์ API เพื่อดูคีย์บัญชีของคุณ
- รับเครดิตทดลอง คลิกหนึ่งครั้งบนหน้านั้นจะเพิ่มเครดิตทดลอง $0.50 จำกัดเพียงหนึ่งครั้งต่อบุคคล และใช้ได้เป็นเวลา 7 วัน
- คัดลอกคีย์ เก็บไว้ในโปรแกรมจัดการรหัสผ่านหรือไฟล์ secrets ทันที
- ส่งคำขอทดสอบ ใช้คำสั่ง curl ด้านล่างก่อนที่คุณจะแตะต้องโค้ดแอปพลิเคชันใดๆ
ปฏิบัติต่อคีย์เหมือนรหัสผ่าน ใครก็ตามที่มีคีย์นี้สามารถใช้จ่ายยอดเงินของคุณได้ หากคุณคิดว่าคีย์รั่วไหล ให้หยุดใช้งานทันที ลบออกจากแอปพลิเคชันทั้งหมด และตรวจสอบยอดเงินของคุณสำหรับการใช้จ่ายที่ไม่คาดคิด
ทดสอบคีย์ด้วย curl
ตั้งค่าคีย์เป็นตัวแปรสภาพแวดล้อมเพื่อให้คีย์ไม่ตกอยู่ในประวัติ shell ของคุณเป็นข้อความธรรมดาภายในสคริปต์ จากนั้นแสดงรายการโมเดล สิ่งนี้ยืนยันว่าคีย์ใช้งานได้และคุณเข้าถึงโฮสต์ที่ถูกต้อง
export API_KEY="paste-your-key-here"
curl https://api.characteraiapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"คุณควรได้รับรายการ JSON ที่มี uncensored ตอนนี้ส่งคำขอแชทแรกด้วยเพอร์โซนาขนาดเล็ก ข้อความระบบจะกำหนดตัวละคร และข้อความผู้ใช้จะเริ่มฉาก
curl https://api.characteraiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
{"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
],
"temperature": 0.9
}'การตอบสนองจะปฏิบัติตามรูปแบบการเสร็จสิ้นการแชทมาตรฐาน ข้อความตอบกลับอยู่ใน choices[0].message.content ส่วนหัวของการตอบสนองยังประกอบด้วย X-Request-Id X-Balance-USD และส่วนหัวขีดจำกัดอัตรา ซึ่งสะดวกเมื่อคุณต้องการแสดงยอดเงินคงเหลือใน UI ของคุณเอง
ใช้คีย์จาก Python หรือ Node
SDK ของ OpenAI ใดๆ ทำงานได้ทันทีที่คุณเปลี่ยนสองค่า: base URL และคีย์ API นี่คือเวอร์ชัน Python พร้อมแพ็กเกจ openai ทางการ
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.characteraiapi.com/v1",
api_key=os.environ["API_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
{"role": "user", "content": "Status report?"},
],
)
print(reply.choices[0].message.content)และคำสั่งเดียวกันใน Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.characteraiapi.com/v1",
apiKey: process.env.API_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "system", content: "You are Mara, a ship engineer. Stay in character." },
{ role: "user", content: "Status report?" },
],
});
console.log(reply.choices[0].message.content);หน้าเว็บแชทจำนวนมากมีช่องสำหรับเอนด์พอยต์ที่เข้ากันได้กับ OpenAI ในเครื่องมือเหล่านั้น คุณวาง base URL วางคีย์ API และพิมพ์ uncensored เป็นชื่อโมเดล ไม่ต้องเปลี่ยนอย่างอื่น หน้าเอกสาร ระบุพารามิเตอร์ที่รองรับ รวมถึงสตรีมมิง การเรียกใช้ฟังก์ชัน และโหมด JSON
ปัญหาทั่วไปของคีย์และการแก้ไขด่วน
ความล้มเหลวครั้งแรกส่วนใหญ่เกิดจากความผิดพลาดเล็กๆ น้อยๆ เพียงไม่กี่อย่าง ตรวจสอบตามลำดับนี้ก่อนจะสงสัยเรื่องใหญ่
- ช่องว่างหรือเครื่องหมายคำพูดส่วนเกินในคีย์ การมี newline ต่อท้ายที่คัดลอกมาจากไฟล์ก็เพียงพอที่จะทำให้การตรวจสอบสิทธิ์ล้มเหลว ให้พิมพ์ความยาวของตัวแปรและเปรียบเทียบกับสิ่งที่คุณคัดลอก
- base URL ผิด base URL ลงท้ายด้วย
/v1และ SDK จะเพิ่ม/chat/completionsให้เอง หากคุณเพิ่ม/chat/completionsลงใน base URL ด้วย เส้นทางจะซ้ำกันและคำขอจะล้มเหลว - ชื่อโมเดลผิด ID ของโมเดลคือ
uncensoredชื่อที่ยืมมาจากบริการอื่นจะไม่ตรงกัน เรียกGET /v1/modelsเพื่อดูว่าเซิร์ฟเวอร์รายงานอะไร - ขาด header การเรียก HTTP ดิบต้องการ
Authorization: Bearerตามด้วยช่องว่างและคีย์ รวมถึงContent-Type: application/jsonในคำขอ POST - ยอดเงินว่างเปล่า header การตอบกลับ
X-Balance-USDแสดงยอดคงเหลือ เมื่อเครดิตทดลองใช้หมดหรือเกิน 7 วัน ให้เติมเงินหรือคำขอจะหยุดทำงาน - ขีดจำกัดอัตรา คีย์ทดลองอนุญาตให้ส่งคำขอพร้อมกัน 2 คำขอและ 60 คำขอต่อนาที การสตรีมที่เปิดอยู่สองสตรีมใช้สล็อตทั้งสองแล้ว
คีย์ที่ไม่ถูกต้องมักทำให้เกิดข้อผิดพลาดการตรวจสอบสิทธิ์แทนที่จะเป็นการตอบกลับจากโมเดล ขีดจำกัดจะส่ง HTTP 429 พร้อมโค้ด rate_limited หรือ concurrency การอ่านเนื้อหาข้อผิดพลาด ไม่ใช่แค่รหัสสถานะ ช่วยประหยัดเวลาเพราะโค้ดบอกคุณว่าคุณชนขีดจำกัดใด ทุกการตอบกลับมี X-Request-Id; เก็บไว้ในบันทึกของคุณ เพื่อให้คุณสามารถจับคู่การเรียกที่ล้มเหลวกับคำขอเฉพาะได้ภายหลัง
ขีดจำกัดของการทดลองใช้และสิ่งที่เครดิตทดลองซื้อได้
คีย์ทดลองมีขีดจำกัดต่ำกว่าคีย์เต็ม: คำขอพร้อมกัน 2 คำขอและ 60 คำขอต่อนาที คีย์เต็มอนุญาตให้คำขอพร้อมกัน 8 คำขอและ 300 คำขอต่อนาที ซึ่งเพียงพอสำหรับการทดสอบเพอร์โซนาเดียว หากคุณรันแชทหลายรายการพร้อมกันจากสคริปต์ทดสอบ คุณจะเห็น HTTP 429 พร้อมรหัสข้อผิดพลาด concurrency หรือ rate_limited คำขอแบบสตรีมจะถือสล็อตความพร้อมกันไว้จนกว่าสตรีมจะสิ้นสุด ดังนั้นสตรีมที่เปิดอยู่สองสตรีมบนคีย์ทดลองจะเติมเต็มสล็อต
เงิน $0.50 ใช้ได้นานแค่ไหน? ราคาอยู่ที่ $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens นำการสนทนาทั่วไปที่มีประวัติและเพอร์โซนา 1,500 tokens เข้าไป และ 300 tokens ออกมา:
- Input: 1,500 โทเคน x $0.15 / 1,000,000 = $0.000225
- Output: 300 โทเคน x $0.50 / 1,000,000 = $0.00015
- หนึ่งรอบ: $0.000375
- $0.50 / $0.000375 มีค่าประมาณ 1,333 รอบ
นี่เพียงพอสำหรับการทดสอบตัวละครหลายตัวอย่างถูกต้อง คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน ดังนั้นคำขอที่ผิดพลาดจะไม่กินเครดิตของคุณ การทดลองใช้หมดอายุหลังจาก 7 วัน; เครดิตที่คุณซื้อภายหลังไม่หมดอายุ
การตั้งค่าที่ทำให้ตัวละครรู้สึกเหมาะสม
คีย์ช่วยให้คุณเชื่อมต่อ; คุณภาพของตัวละครมาจากพรอมต์และการตั้งค่า sampling นิสัยไม่กี่อย่างช่วยได้มากกว่าเทคนิคที่ฉลาด
เขียนข้อความระบบเป็นแผ่นตัวละครสั้นๆ ในประโยคธรรมดา: ตัวละครคือใคร พูดอย่างไร ต้องการอะไร และควรตอบยาวแค่ไหน ให้ตัวอย่างบรรทัดการสนทนาหนึ่งหรือสองบรรทัดหากน้ำเสียงสำคัญ โมเดลทำตามตัวอย่างที่เป็นรูปธรรมได้ดีกว่าคำคุณศัพท์ ดังนั้นบรรทัดเช่น "Mara ตอบด้วยประโยคสั้นๆ แห้งๆ และชอบพูดตลกเมื่อประหม่า" จึงทำงานได้ดีกว่า "Mara ฉลาดและน่าดึงดูด"
ใช้ temperature เพื่อตั้งค่าความมีชีวิตชีวา ค่าที่ใกล้ 0.9 ให้รูปแบบที่หลากหลายมากขึ้น ในขณะที่ค่าที่ใกล้ 0.5 ทำให้ตัวละครมีความเสถียรมากขึ้น เพิ่มลำดับ stop หากแอปของคุณใช้ป้ายชื่อผู้พูดเช่น "User:" และคุณต้องการป้องกันไม่ให้โมเดลเขียนอีกฝั่งของการสนทนา ค่า frequency penalty และ presence penaltyสามารถลดประโยคที่ซ้ำกันในการแชทที่ยาวนานได้ แต่เพิ่มอย่างระมัดระวังเนื่องจากค่าสูงอาจทำให้การสนทนาแปลกไป
จำไว้ว่าโมเดลรู้เฉพาะสิ่งที่อยู่ในคำขอเท่านั้น หากตัวละครควรจำชื่อผู้เล่นจาก 200 ข้อความที่แล้ว ให้เก็บข้อความนั้นไว้ในหน้าต่างบริบทหรือเก็บข้อเท็จจริงสำคัญไว้ในข้อความระบบ นี่คือเหตุผลที่รายการความจำที่คุณอัปเดตเองมักดีกว่าการส่งประวัติที่ยาวมาก
เติมเงินเมื่อเครดิตทดลองใช้หมด
ไม่มีระบบสมาชิก คุณจ่ายล่วงหน้าและใช้โทเคนตามจริง การเติมเงินรับจำนวนเต็มตั้งแต่ $20 ถึง $500 และจำนวนที่สูงกว่ามีโบนัส: +5% จาก $50, +10% จาก $100 และ +15% จาก $200 ดังนั้น $50 จะได้เครดิต $52.50, $100 ได้ $110 และ $200 ได้ $230 คุณสามารถจ่ายด้วยคริปโต (USDT บน TRC20, USDC บน Base)
หน้าราคา มีตารางเต็ม สำหรับการวางแผน รอบที่มี input 1,500 และ output 300 โทเคนแบบเดียวกันมีค่าใช้จ่าย $0.000375 ดังนั้น $20 ครอบคลุมการสนทนาประมาณ 53,000 ครั้ง บทบาทสมมติที่ยาวนานมีค่าใช้จ่ายมากกว่าต่อรอบเนื่องจากประวัติเพิ่มขึ้น ดังนั้นจำกัดปริมาณที่คุณส่งกลับ หน้าต่างบริบทคือ 100,000 tokens ทั้งพรอมต์และการเติมเต็ม แต่คุณมักไม่ต้องการที่จะเติมเต็ม
การเก็บคีย์ให้ปลอดภัยในแอปจริง
ข้อผิดพลาดที่พบบ่อยที่สุดคือเรียก API โดยตรงจากโค้ดเบราว์เซอร์ สิ่งใดๆ ที่ส่งไปยังเบราว์เซอร์สามารถถูกอ่านได้โดยผู้เยี่ยมชมทุกคน รวมถึงคีย์ ให้วางเซิร์ฟเวอร์เล็กๆ ระหว่างหน้าเว็บและ API เบราว์เซอร์จะสื่อสารกับเส้นทางของคุณ เส้นทางของคุณเพิ่ม Authorization: Bearer ส่วนหัวและส่งคำขอต่อ
- เก็บคีย์ในตัวแปรสภาพแวดล้อมหรือตัวจัดการความลับ ไม่ใช่ในที่เก็บ
- เพิ่มการตั้งค่า
.envใน.gitignoreก่อนคอมมิตครั้งแรก - ใช้คีย์หนึ่งต่อสภาพแวดล้อมเพื่อให้การรั่วไหลในการพัฒนาไม่กระทบการผลิต
- ติดตามหัว
X-Balance-USDเพื่อจับลูปที่ทำงานไม่หยุดแต่เนิ่นๆ - ลองใหม่เมื่อได้ HTTP 429 โดยรอสั้นๆ การตอบสนองโอเวอร์โหลดชั่วคราวรวม
Retry-After: 5
พรอมต์ที่ส่งไปยัง API ไม่ถูกใช้สำหรับการฝึกฝน แม้กระนั้น หลีกเลี่ยงการส่งข้อมูลที่คุณไม่ต้องการเก็บในบันทึกฝั่งของคุณ หากต้องการดูลึกขึ้นว่า API แบบนั้นทำอะไรและไม่ทำอะไร บทความเรื่องความเชื่อผิดๆ และข้อเท็จจริง ครอบคลุมความเข้าใจผิดทั่วไป