PuterAi python_SDK

PUTERAI-PYTHON_SDK

Puterai Python SDK เป็นวิธีง่ายๆในการโต้ตอบกับ PuTer AI API สำหรับการโต้ตอบ chatbot และการสร้างข้อความกับการพูด (TTS) SDK นี้ช่วยให้คุณสามารถรวมฟังก์ชัน chatbot และ TTS เข้ากับแอปพลิเคชันของคุณเอง

คุณสมบัติ

• การโต้ตอบ chatbot : สื่อสารกับ chatbot ที่ขับเคลื่อนโดย Puter AI
• Text-to-Speech (TTS) : แปลงข้อความใด ๆ เป็นเสียงโดยใช้บริการ AWS Polly TTS

โครงสร้างโครงการ

โครงการประกอบด้วยหลายองค์ประกอบ:

• login.py : สคริปต์เพื่อจัดการการเข้าสู่ระบบของผู้ใช้และดึงโทเค็น API สำหรับคำขอเพิ่มเติม
• cli.py : อินเทอร์เฟซบรรทัดคำสั่งที่อนุญาตให้ผู้ใช้โต้ตอบกับ PUTER ChatBot หรือสร้างเอาต์พุต TTS
• server.py : เซิร์ฟเวอร์ API ที่ใช้ขวดที่เปิดเผยจุดสิ้นสุดสำหรับฟังก์ชัน chatbot และ TTS
• example.html : Front-end HTML ง่าย ๆ เพื่อโต้ตอบกับ chatbot และสร้าง TTS ผ่านเบราว์เซอร์

ความต้องการ

ในการเรียกใช้โครงการนี้คุณต้องติดตั้งการพึ่งพาต่อไปนี้:

• requests : เพื่อจัดการคำขอ HTTP
• flask : สำหรับเซิร์ฟเวอร์ API
• flask_cors : สำหรับการจัดการการแบ่งปันทรัพยากรข้ามต้นกำเนิด (CORS)
• dotenv : เพื่อโหลดตัวแปรสภาพแวดล้อมจากไฟล์. ENV

คุณสามารถติดตั้งการพึ่งพาที่จำเป็นด้วย:

pip install -r requirements.txt

คำแนะนำการตั้งค่า

1. โคลนที่เก็บ

git clone https://github.com/mowhn/PuterAi-python_SDK.git
cd puterAi-python_SDK

2. การตั้งค่าไฟล์. env ทั้งในโฟลเดอร์ CLI และ API

สร้างไฟล์ .env ทั้งในไดเรกทอรี cli และ API และรวม API_Token ของคุณ:

 API_TOKEN = your_api_token_here

3. รับโทเค็น API

หากต้องการรับ API_TOKEN ของคุณอย่างรวดเร็วคุณต้องเรียก login.py ก่อนเพื่อเข้าสู่ระบบและดึงโทเค็น:

• เรียกใช้ login.py :

   cd cli
  python login.py

  สิ่งนี้จะแจ้งให้คุณทราบชื่อผู้ใช้และรหัสผ่านของคุณและหากการเข้าสู่ระบบสำเร็จมันจะส่งออก API_TOKEN คุณสามารถคัดลอกโทเค็นนี้และวางลงในไฟล์ .env ทั้งในโฟลเดอร์ cli และ API

  หมายเหตุ : หากคุณไม่มีบัญชี AI PUTER คุณสามารถสมัครได้ที่

4. ดำเนินโครงการ

• เรียกใช้เซิร์ฟเวอร์ API:

   cd API
  python server.py

  สิ่งนี้จะเริ่มต้นเซิร์ฟเวอร์ Flask API บน http://localhost:5000

• ใช้อินเทอร์เฟซบรรทัดคำสั่ง (CLI):

  หากต้องการโต้ตอบกับ chatbot หรือสร้าง TTS จากบรรทัดคำสั่งให้เรียกใช้:

   cd cli
  python cli.py

5. ตัวอย่างส่วนหน้า

เปิดไฟล์ example.html ในเบราว์เซอร์เพื่อโต้ตอบกับ puter chatbot และสร้าง TTS:

• แชทกับบอท : ป้อนข้อความและรับคำตอบจากบอท
• สร้าง TTS : ป้อนข้อความเพื่อแปลงเป็นคำพูดและเล่นเสียงที่สร้างขึ้น

จุดปลาย

Flask API เปิดเผยจุดสิ้นสุดต่อไปนี้:

• โพสต์ /chat : ยอมรับวัตถุ JSON ด้วยฟิลด์ message และส่งคืนการตอบกลับบอท

  คำขอตัวอย่าง:

  {
    "message" : " Hello, bot! "
  }

• โพสต์ /tts : ยอมรับวัตถุ JSON ที่มีฟิลด์ text และส่งคืนเสียง TTS ที่เกี่ยวข้อง

  คำขอตัวอย่าง:

  {
    "text" : " Hello, this is a test. "
  }

ใบอนุญาต

โครงการนี้ได้รับใบอนุญาตภายใต้ใบอนุญาต MIT - ดูไฟล์ใบอนุญาตสำหรับรายละเอียด

---

สนุกกับการสร้างด้วย Puter!