คู่มือ Token API

1. สร้างบัญชี

ลงทะเบียนบัญชี TATC และเข้าสู่คอนโซล Token API ซึ่งเป็นจุดรวมสำหรับ API Key การเข้าถึงโมเดล การใช้งาน และข้อมูลค่าใช้จ่าย

2. เปิดหน้าจัดการ API Key

จากคอนโซล เปิดหน้าจัดการ API Key แล้วเลือกสร้างคีย์สำหรับแอปพลิเคชัน สภาพแวดล้อม หรือเวิร์กโฟลว์ของทีม

3. กำหนดค่าคีย์

ฟิลด์และการควบคุมในคอนโซลกำหนดตามรูปแบบบริการที่เลือก

• ตั้งชื่อคีย์ให้ชัดเจนตามแอปพลิเคชันและสภาพแวดล้อม
• เลือกโมเดลต้นทางที่คีย์สามารถเข้าถึง
• กำหนดขีดจำกัดอัตราและโควตาการใช้งาน

4. เก็บและจัดการคีย์อย่างปลอดภัย

• เก็บคีย์ในตัวแปรสภาพแวดล้อมฝั่งเซิร์ฟเวอร์หรือระบบจัดการความลับ
• อย่าใส่คีย์ในโค้ดเบราว์เซอร์ แอปมือถือ ที่เก็บโค้ดสาธารณะ หรือภาพหน้าจอ
• ปิดหรือเปลี่ยนคีย์เมื่อแอปพลิเคชันเปลี่ยนหรือสงสัยว่าคีย์รั่วไหล

1. เลือกโมเดลต้นทาง

ดูแคตตาล็อก เปรียบเทียบความสามารถ แล้วเลือกเส้นทางโมเดลต้นทางที่เหมาะกับงาน จากนั้นคัดลอกรหัสโมเดลที่แพลตฟอร์มแสดง

2. เตรียมข้อมูลเชื่อมต่อ

ตั้งค่า endpoint ของเกตเวย์ API Key และรหัสโมเดลเป็นตัวแปรสภาพแวดล้อมฝั่งเซิร์ฟเวอร์ ชื่อต่อไปนี้เป็นรูปแบบตัวอย่าง

• TATC_BASE_URL: URL ฐานของ API
• TATC_API_KEY: คีย์เข้าถึง
• TATC_MODEL_ID: รหัสโมเดลต้นทางที่เลือก

3. ส่งคำขอทดสอบขนาดเล็ก

ตัวอย่าง cURL แสดงรูปแบบคำขอที่เข้ากันได้กับ OpenAI แทนค่าตัวอย่างด้วยค่าที่คอนโซลแสดง

# Example integration pattern. Use the details supplied by TATC.
export TATC_API_KEY="<issued-key>"
export TATC_BASE_URL="https://<confirmed-host>/v1"
export TATC_MODEL_ID="<confirmed-model-id>"

curl "$TATC_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $TATC_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$(printf '{"model":"%s","messages":[{"role":"user","content":"Hello"}]}' "$TATC_MODEL_ID")"

4. ใช้ไคลเอนต์ที่รองรับ

เกตเวย์รองรับการเชื่อมต่อรูปแบบ OpenAI และ Anthropic ที่คุ้นเคย กำหนดค่าไคลเอนต์ด้วย URL ฐาน API Key และรหัสโมเดลที่เลือก

# Example OpenAI-compatible pattern.
import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["TATC_BASE_URL"],
    api_key=os.environ["TATC_API_KEY"],
)
response = client.chat.completions.create(
    model=os.environ["TATC_MODEL_ID"],
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

5. ตรวจสอบผลตอบกลับและการใช้งาน

การสตรีม การเรียกใช้เครื่องมือ และอินพุตหลายรูปแบบขึ้นอยู่กับโมเดลต้นทางที่เลือก ค่อยเพิ่มหลังคำขอพื้นฐานทำงาน

• ตรวจสอบผล HTTP และเนื้อหาที่ส่งกลับ
• บันทึกรหัสคำขอหากมี
• เปิดคอนโซลเพื่อตรวจสอบโมเดล API Key การใช้โทเคน และข้อมูลค่าใช้จ่าย

การเลือกโมเดลและโปรโตคอล

เลือกโมเดลต้นทางที่รองรับและใช้เส้นทางที่แสดงในแคตตาล็อก อินเทอร์เฟซรูปแบบ OpenAI และ Anthropic ช่วยให้ SDK และเครื่องมือนักพัฒนาที่มีอยู่เชื่อมต่อได้ด้วยการเปลี่ยน URL ฐาน คีย์ และรหัสโมเดล

การยืนยันตัวตนและการเปลี่ยนคีย์

ใช้คีย์จากระบบฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้เท่านั้น บันทึกว่าแอปพลิเคชันใดใช้คีย์แต่ละชุด และใช้การควบคุมในคอนโซลเพื่อปิดหรือเปลี่ยนคีย์เมื่อสิทธิ์เปลี่ยนหรือสงสัยว่าคีย์รั่วไหล

การจัดการคำขอที่ผิดพลาด

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

• หากได้รับผลตอบกลับเกี่ยวกับการยืนยันตัวตนหรือสิทธิ์ ให้ตรวจสอบคีย์ endpoint และสิทธิ์โมเดลก่อนลองใหม่
• หากได้รับผลตอบกลับเกี่ยวกับข้อจำกัด ให้ทำตามแนวทางลองใหม่ที่ตกลงกันและหลีกเลี่ยงการส่งซ้ำอย่างถี่
• เมื่อเกิดข้อผิดพลาดชั่วคราว ให้เก็บเวลา รหัสคำขอหากมี และสรุปคำขอที่ลบข้อมูลอ่อนไหวแล้วสำหรับฝ่ายสนับสนุน

การใช้งานและการเรียกเก็บเงิน

คอนโซลรวมจำนวนคำขอ การใช้โทเคน การใช้งานตามโมเดลและ API Key โควตา และข้อมูลค่าใช้จ่าย โดยรูปแบบราคาและการเรียกเก็บเงินขึ้นอยู่กับรูปแบบบริการที่เลือก

เมื่อติดต่อฝ่ายสนับสนุน

• ระบุบริการ รหัสโมเดล เวลาโดยประมาณ และรหัสคำขอหากมี
• อธิบายสถานะที่พบและปัญหาเกิดซ้ำได้หรือไม่
• ลบคีย์ API ข้อมูลส่วนบุคคล และ prompt ที่เป็นความลับออกจากภาพหน้าจอหรือบันทึกก่อนส่ง