AI Gridเอกสาร
สมัครใช้งาน

เริ่มต้นอย่างรวดเร็ว

จากการลงชื่อเข้าใช้ครั้งแรกจนถึงการเรียก API สำเร็จ ภายในเวลาประมาณห้านาที

newอัปเดต 10 ก.ย. 2026

1. ลงชื่อเข้าใช้ — ระบบสร้างพื้นที่ทำงานส่วนตัวให้คุณ#

ลงชื่อเข้าใช้ที่ app.aigridapp.com ด้วยบัญชีองค์กรของคุณ คอนโซลยืนยันตัวตนผ่านการลงชื่อเข้าใช้ครั้งเดียว (single sign-on)

การลงชื่อเข้าใช้ครั้งแรกจะสร้างพื้นที่ทำงานส่วนตัว (personal workspace) ให้อัตโนมัติ ประกอบด้วยองค์กรส่วนตัวที่มีคุณเป็นเจ้าของ (Owner) ทีมที่ระบบจัดการให้ โปรเจกต์ที่ระบบจัดการให้ และกระเป๋าเงินของโปรเจกต์ ไม่ต้องยื่นคำขอและไม่ต้องรออนุมัติ พื้นที่ทำงานพร้อมใช้งานทันทีที่คุณเข้าสู่ระบบ

2. เติมเงินเข้ากระเป๋าเงินของโปรเจกต์#

กระเป๋าเงินอยู่ที่ระดับโปรเจกต์ และโปรเจกต์ใหม่จะ ยังไม่มีเงิน การเรียกใช้จะล้มเหลวด้วย 402 insufficient_budget จนกว่าคุณจะเติมเงิน ในพื้นที่ทำงานส่วนตัวคุณเป็นเจ้าของอยู่แล้ว จึงเปิดหน้า Wallet ของโปรเจกต์แล้วเลือก Add funds (ระหว่าง $5 ถึง $10,000) การเติมเงินจะสรุปยอดกับ ระเบียนการเรียกเก็บเงิน (billing record) จาก Settings → Billing หากกล่องโต้ตอบแจ้งว่ายังไม่มีระเบียน ให้เพิ่มที่นั่นก่อน จากนั้นกด Add $X เพื่อยืนยัน กระเป๋าเงินจะได้รับเครดิตทันที

3. สร้างคีย์ API ที่ผูกกับโปรเจกต์#

เปิด API keys แล้วสร้างคีย์ โดยเลือกโปรเจกต์ที่คีย์นั้นสังกัด ทุกคีย์ผูกกับ โปรเจกต์เดียวเท่านั้น และโปรเจกต์นั้นคือบริบทการคิดค่าใช้จ่ายของทุกการเรียกที่คีย์นั้นทำ

คีย์มีรูปแบบ aig_… และระบบจะ แสดงค่าลับเพียงครั้งเดียว โปรดบันทึกไว้ก่อนปิดหน้า คีย์มีอายุ 90 วันตามค่าเริ่มต้น (ตั้งได้ตั้งแต่ 1 ถึง 365 วันตอนสร้าง) และคุณเลือกจำกัดคีย์ให้เรียกได้เฉพาะรายการโมเดลที่กำหนด พร้อมตั้งวงเงินใช้จ่ายที่รีเซ็ตแบบ daily weekly monthly หรือ lifetime ได้

ในพื้นที่ทำงานส่วนตัวไม่มีขั้นตอนการกำหนดผลิตภัณฑ์ โปรเจกต์ที่ระบบจัดการให้สามารถเข้าถึงผลิตภัณฑ์ที่เผยแพร่แล้วทุกรายการที่พื้นที่ทำงานมองเห็น ส่วนในองค์กรของบริษัท เจ้าขององค์กรหรือผู้ดูแลต้องกำหนดเวอร์ชันผลิตภัณฑ์ที่โปรเจกต์เรียกใช้ได้ก่อน โมเดลที่ยังไม่ได้กำหนดจะตอบ 403 product_not_assigned

4. ชี้ SDK ของคุณมาที่ AI Grid#

app.py
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.aigridapp.com/v1",  # <- the only change
    api_key=os.environ["AIGRID_API_KEY"],
)

reply = client.chat.completions.create(
    model="openai/gpt-oss-20b",
    messages=[{"role": "user", "content": "Hello, grid."}],
)
print(reply.choices[0].message.content)

หรือเรียกจากเชลล์โดยตรง

bash
curl https://api.aigridapp.com/v1/chat/completions \
  -H "Authorization: Bearer $AIGRID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-oss-20b", "messages": [{"role": "user", "content": "Hello, grid."}]}'

เนื่องจากคีย์ระบุโปรเจกต์อยู่แล้ว คุณจึงไม่ต้องเลือกโปรเจกต์ในแต่ละการเรียก เฮดเดอร์ X-AIGrid-Project ที่ไม่บังคับนั้นใช้ ระบุซ้ำ โปรเจกต์ที่ผูกไว้ได้เท่านั้น หากระบุค่าอื่นจะถูกปฏิเสธด้วย 403 project_mismatch เรียก GET /v1/models ด้วยคีย์เดียวกันเพื่อดูรายการทั้งหมดที่คีย์นั้นเรียกใช้ได้

ทุกการเรียกใช้จะถูกวัดปริมาณย้อนกลับไปยังโปรเจกต์ ผลิตภัณฑ์ และบุคคลที่เรียก ดู การใช้งานและการวัดปริมาณ