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

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

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

How to get your API Key

ไปที่หน้า Playground > API Keys

คุณจะต้องสร้างบัญชีและล็อกอินให้เรียบร้อยก่อน

ทำการเรียก 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 โดยละเอียด
• สำรวจ ตัวอย่าง สำหรับกรณีการใช้งานทั่วไป
• อ่านเกี่ยวกับ การเขียนพรอมต์ เพื่อรับผลลัพธ์ที่ดีขึ้น
• เรียนรู้เกี่ยวกับ โมเดล เพื่อเข้าใจว่าโมเดลใดเหมาะกับความต้องการของคุณมากที่สุด