ส่งคำขอแรก

คู่มือนี้จะพาคุณทำการเรียก API ครั้งแรกตั้งแต่เริ่มต้น ก่อนเริ่มต้น โปรดตรวจสอบให้แน่ใจว่า:

1. คุณได้สร้างคีย์ APIและบันทึกคีย์แบบเต็มไว้แล้ว
2. คุณมี Base URL: เข้าสู่ระบบคอนโซล เปิดกล่อง "เริ่มต้นอย่างรวดเร็ว" เลือกโปรโตคอลแล้วคัดลอก ที่อยู่ ตัวอย่างด้านล่างใช้ https://<your-base-url> เป็นตัวแทน ให้แทนที่ด้วยที่อยู่จริงของคุณ

แพลตฟอร์มรองรับโปรโตคอลเนทีฟสามแบบ เลือกแบบที่เหมาะกับคุณได้เลย การคิดค่าบริการและยอดคงเหลือเหมือนกันทั้งสามแบบ

โปรโตคอลแบบ OpenAI-compatible (แนะนำเป็นค่าเริ่มต้น)

เข้ากันได้เต็มรูปแบบกับ OpenAI SDK เพียงกำหนด base_url ให้ชี้มาที่แพลตฟอร์ม โค้ดเดิมของคุณก็ใช้งานได้ต่อ

cURL

curl https://<your-base-url>/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://<your-base-url>",
)

completion = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)

Node.js (openai SDK)

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<your-base-url>",
})

const completion = await client.chat.completions.create({
  model: "your-model",
  messages: [{ role: "user", content: "Hello" }],
})
console.log(completion.choices[0].message.content)

โปรโตคอล Anthropic

เทียบเท่ากับ Anthropic Messages API ยืนยันตัวตนด้วย x-api-key และแนบ anthropic-version มาด้วย:

curl https://<your-base-url>/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

โปรโตคอล Gemini

เทียบเท่ากับ Google GenAI API ID โมเดลจะอยู่ในพาธ และการยืนยันตัวตนใช้ x-goog-api-key:

curl "https://<your-base-url>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

ตรวจสอบผลลัพธ์

คำขอที่สำเร็จจะคืนคำตอบของโมเดลกลับมา (สำหรับโปรโตคอล OpenAI จะอยู่ใน choices[0].message.content) จากนั้นคุณสามารถ:

• ตรวจสอบปริมาณการใช้งานและการเปลี่ยนแปลงของยอดคงเหลือได้ที่หน้า "การใช้งาน" ในคอนโซล
• แทนที่ your-model ด้วย ID โมเดลจริงจากตลาดโมเดล (รองรับทั้งประเภทข้อความ รูปภาพ เสียง วิดีโอ และไฟล์)

ข้อผิดพลาดที่พบบ่อยในการเรียกครั้งแรก

เคล็ดลับสำหรับโปรดักชัน: เก็บคีย์ไว้ในตัวแปรสภาพแวดล้อม (เช่น OPENAI_API_KEY) แทนการฝังไว้ในโค้ด และเลือกใช้ SDK อย่างเป็นทางการแทนการเขียน HTTP เรียกเอง เพราะ SDK จัดการรายละเอียดความเข้ากันได้ของโปรโตคอลให้แล้ว