TH ▾
รับคีย์ API

คีย์ API Character AI: วิธีรับและใช้งาน

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

คีย์เรืองแสงเหนือแผงแชทที่เชื่อมต่อกับลูกบาศก์เซิร์ฟเวอร์ แสดงการเข้าถึงคีย์ API

ประเด็นสำคัญ

  1. คุณจะได้รับคีย์หลังจากสมัครสมาชิกด้วย Google หรืออีเมลและรหัสผ่าน จากนั้นเปิดหน้าคีย์ API
  2. ผู้ใช้ใหม่สามารถรับเครดิตทดลอง $0.50 ได้ด้วยการคลิกหนึ่งครั้ง ไม่ต้องใช้บัตร และใช้ได้เป็นเวลา 7 วัน
  3. ใช้ Base URL https://api.characteraiapi.com/v1 และ model ID uncensored กับ SDK ของ OpenAI ใดๆ ก็ได้
  4. เก็บคีย์ไว้บนเซิร์ฟเวอร์หรือในตัวแปรสภาพแวดล้อม ห้ามใส่ไว้ในโค้ดฝั่งหน้าเว็บที่เปิดเผยต่อสาธารณะ

สิ่งที่คุณจะได้รับจริงๆ

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 เก็บประวัติการสนทนา และส่งไปกับแต่ละคำขอ สิ่งนี้ให้คุณควบคุมเสียง ความจำ และจังหวะการสนทนาที่ผลิตภัณฑ์แบบปิดมักไม่เปิดเผย ขีดจำกัดที่เข้มงวดมีเท่ากันสำหรับผู้ใช้ทุกคน: ไม่มีเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ โดยเด็ดขาด

รับคีย์ของคุณในห้าขั้นตอน

เส้นทางทั้งหมดใช้เวลาเพียงไม่กี่นาที คุณไม่จำเป็นต้องใช้บัตรเพื่อเริ่มต้น

  1. สมัครสมาชิก ใช้ Google หรือลงทะเบียนด้วยอีเมลและรหัสผ่าน
  2. เปิดหน้าคีย์ ไปที่ หน้าคีย์ API เพื่อดูคีย์บัญชีของคุณ
  3. รับเครดิตทดลอง คลิกหนึ่งครั้งบนหน้านั้นจะเพิ่มเครดิตทดลอง $0.50 จำกัดเพียงหนึ่งครั้งต่อบุคคล และใช้ได้เป็นเวลา 7 วัน
  4. คัดลอกคีย์ เก็บไว้ในโปรแกรมจัดการรหัสผ่านหรือไฟล์ secrets ทันที
  5. ส่งคำขอทดสอบ ใช้คำสั่ง 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 แบบนั้นทำอะไรและไม่ทำอะไร บทความเรื่องความเชื่อผิดๆ และข้อเท็จจริง ครอบคลุมความเข้าใจผิดทั่วไป

ถาม-ตอบ

สิ่งนี้ให้คีย์ Character.ai API แก่ฉันหรือไม่?

ไม่ นี่คือบริการแยกต่างหากและเป็นอิสระ คุณรับคีย์สำหรับเอนด์พอยต์ที่เข้ากันได้กับ OpenAI พร้อมmodel ID uncensored ซึ่งคุณสามารถใช้เป็นแบ็กเอนด์สำหรับแอปตัวละครของคุณเอง

ฉันต้องมีบัตรเพื่อรับคีย์หรือไม่?

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

ฉันสามารถใช้คีย์ใน SillyTavern หรือหน้าแชทอื่นๆ ได้หรือไม่?

เครื่องมือที่ยอมรับเอนด์พอยต์ที่เข้ากันได้กับ OpenAI สามารถใช้ได้ ป้อน base URL คีย์ของคุณ และชื่อโมเดล uncensored

เกิดอะไรขึ้นเมื่อฉันถึงขีดจำกัดอัตรา?

API ส่ง HTTP 429 พร้อมรหัส rate_limited หรือ concurrency รอสักครู่แล้วลองใหม่ คีย์ทดลองอนุญาตคำขอพร้อมกัน 2 คำขอและ 60 คำขอต่อนาที

เครดิตหมดอายุหรือไม่?

เครดิตที่ซื้อไม่หมดอายุ มีเพียงเครดิตทดลองใช้ $0.50 ที่มีระยะเวลา 7 วัน

คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว

สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด

รับคีย์ API