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

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

รับคีย์ API ของคุณ

1. ลงทะเบียนที่ OpenTyphoon.ai
2. นำทางไปยังส่วน API Keys ในแดชบอร์ดของคุณ
3. สร้างคีย์ API ใหม่
4. เก็บคีย์ API ของคุณไว้อย่างปลอดภัย - จะไม่แสดงอีกครั้ง!

ทำการเรียก API ครั้งแรกของคุณ

cURL

curl --location 'https://api.opentyphoon.ai/v1/chat/completions' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <YOUR_API_KEY>' \
    --data '{
        "model": "typhoon-v2.1-12b-instruct",
        "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant. You must answer only in Thai."
        },
        {
            "role": "user",
            "content": "ขอสูตรไก่ย่าง"
        }
        ],
        "max_tokens": 512,
        "temperature": 0.6,
        "top_p": 0.95,
        "repetition_penalty": 1.05,
        "stream": false
    }'

Python

from openai import OpenAI

# เริ่มต้นไคลเอนต์ด้วยคีย์ API ของคุณและ URL ฐานของ OpenTyphoon
client = OpenAI(
    api_key="<YOUR_API_KEY>",
    base_url="https://api.opentyphoon.ai/v1"
)

# ทำคำขอการสร้างข้อความ
response = client.chat.completions.create(
    model="typhoon-v2.1-12b-instruct",
    messages=[
        {"role": "system", "content": "You are a helpful assistant. You must answer only in Thai."},
        {"role": "user", "content": "ขอสูตรไก่ย่าง"}
    ],
    max_tokens=512,
    temperature=0.6
)

# พิมพ์การตอบกลับ
print(response.choices[0].message.content)

JavaScript

import OpenAI from 'openai';

// เริ่มต้นไคลเอนต์ด้วยคีย์ API ของคุณและ URL ฐานของ OpenTyphoon
const openai = new OpenAI({
  apiKey: '<YOUR_API_KEY>',
  baseURL: 'https://api.opentyphoon.ai/v1',
});

async function main() {
  const response = await openai.chat.completions.create({
    model: 'typhoon-v2.1-12b-instruct',
    messages: [
      {
        role: 'system',
        content: 'You are a helpful assistant. You must answer only in Thai.'
      },
      {
        role: 'user',
        content: 'ขอสูตรไก่ย่าง'
      }
    ],
    max_tokens: 512,
    temperature: 0.6
  });

  console.log(response.choices[0].message.content);
}

main();

การใช้งาน Typhoon OCR

สำหรับงานแยกวิเคราะห์เอกสารและ OCR คุณสามารถใช้โมเดลเฉพาะทาง typhoon-ocr ของเรา:

Python

# ติดตั้งแพ็คเกจ
pip install typhoon-ocr

# ใช้ฟังก์ชัน OCR
from typhoon_ocr import ocr_document

# กรุณาตั้งค่าสภาพแวดล้อม TYPHOON_OCR_API_KEY หรือ OPENAI_API_KEY เพื่อใช้ฟังก์ชันนี้
markdown = ocr_document("test.png")
print(markdown)

โมเดล OCR จะประมวลผลเอกสารของคุณและส่งคืนข้อความที่สกัดได้ในรูปแบบ markdown โดยได้รับการปรับให้เหมาะสมสำหรับการรู้จำข้อความภาษาไทยและการรักษาโครงสร้างเอกสาร

การตั้งค่าพารามิเตอร์ที่แนะนำ

สำหรับผลลัพธ์ที่ดีที่สุดกับโมเดล Typhoon เราแนะนำการตั้งค่าพารามิเตอร์ดังต่อไปนี้:

พารามิเตอร์	ค่าที่แนะนำ	คำอธิบาย
temperature	0.6	ควบคุมความสุ่ม ค่าต่ำเช่น 0.2 สำหรับการตอบกลับที่เป็นข้อเท็จจริง/สอดคล้อง ค่าสูงกว่า (0.8+) สำหรับการตอบกลับที่สร้างสรรค์มากขึ้น
max_tokens	512	ปรับตามความยาวของการตอบกลับที่คุณคาดหวัง
top_p	0.95	ทางเลือกแทน temperature สำหรับการควบคุมความสุ่ม
repetition_penalty	1.05	ป้องกันข้อความซ้ำซาก เพิ่มเล็กน้อย (1.1-1.2) หากคุณสังเกตเห็นการซ้ำ

ขั้นตอนถัดไป

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