บทช่วยสอน 2slides API - คู่มือฉบับสมบูรณ์สำหรับการสร้างงานนำเสนอด้วย AI

ยินดีต้อนรับสู่คู่มือฉบับสมบูรณ์สำหรับ 2slides API! บทช่วยสอนนี้จะแนะนำคุณตลอดทุกสิ่งที่คุณจำเป็นต้องรู้เพื่อผสานรวมการสร้างงานนำเสนอที่ขับเคลื่อนด้วย AI เข้ากับแอปพลิเคชันของคุณ

ภาพรวม

2slides API ช่วยให้คุณสามารถสร้างงานนำเสนอระดับมืออาชีพด้วยโปรแกรมโดยใช้ AI ด้วยการรองรับประเภทงานนำเสนอที่หลากหลาย รวมถึงไทม์ไลน์, โรดแมป, มายด์แมป และอื่นๆ อีกมากมาย คุณสามารถสร้างสไลด์ที่สวยงามจากข้อความอินพุตที่เรียบง่าย

คุณสมบัติหลัก

• การสร้างที่ขับเคลื่อนด้วย AI: สร้างงานนำเสนอระดับมืออาชีพจากข้อความโดยอัตโนมัติ
• ประเภทเทมเพลตที่หลากหลาย: รองรับไทม์ไลน์, โรดแมป, มายด์แมป, พิตช์เด็ค, อินโฟกราฟิก และอื่นๆ
• รองรับหลายภาษา: สร้างเนื้อหาได้หลายภาษา
• คลังเทมเพลตที่หลากหลาย: เข้าถึงเทมเพลตที่ออกแบบอย่างมืออาชีพหลายร้อยแบบ
• เทมเพลตที่กำหนดเอง: อัปโหลดและใช้เทมเพลตสไลด์ที่คุณกำหนดเอง
• ค้นหาเทมเพลต: ค้นหาเทมเพลตผ่านชื่อ, คีย์เวิร์ด และแท็ก
• ตัวเลือกการดาวน์โหลด: รับงานนำเสนอในรูปแบบ PowerPoint (.pptx)
• การติดตามสถานะแบบเรียลไทม์: ตรวจสอบความคืบหน้าของการสร้างด้วยเอนด์พอยต์สถานะงาน

ประเภทงานนำเสนอเด่น

เทมเพลตงานนำเสนอทั้งหมดมีอยู่ที่นี่: 2slides Templates โดยเฉพาะอย่างยิ่ง มีประเภทงานนำเสนอเด่นบางประเภทที่ทำงานได้ดีมากสำหรับวัตถุประสงค์และสถานการณ์เฉพาะ

1. สไลด์ไทม์ไลน์ (Timeline Slides) - เหมาะสำหรับไทม์ไลน์โครงการและเหตุการณ์ทางประวัติศาสตร์
2. สไลด์โรดแมป (Roadmap Slides) - เหมาะสำหรับโรดแมปผลิตภัณฑ์และการวางแผนโครงการ
3. สไลด์มายด์แมป (Mind Map Slides) - ยอดเยี่ยมสำหรับการทำแผนที่แนวคิดและโครงสร้างความรู้

เริ่มต้นใช้งาน

Base URL

คำขอ API ทั้งหมดควรส่งไปยัง:

https://2slides.com

ข้อกำหนดเบื้องต้น

1. การตั้งค่าบัญชี: สร้างบัญชีที่ 2slides.com
2. API Key: สร้าง API key จาก หน้าการจัดการ API ของคุณ
3. เครดิต: ตรวจสอบให้แน่ใจว่าคุณมีเครดิตเพียงพอสำหรับการสร้างสไลด์ (10 เครดิตต่อหน้าสไลด์)

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

1. รับ API key ของคุณ จาก หน้าการจัดการ API
2. ค้นหาธีม โดยใช้เอนด์พอยต์ค้นหาธีม หรือเรียกดู เทมเพลต เพื่อ รับ ID ธีมสไลด์
3. สร้างสไลด์ ด้วยเนื้อหาและ ID ธีมที่คุณเลือก ซึ่งรองรับทั้งการเรียกใช้แบบซิงโครนัสพร้อมสไลด์ผลลัพธ์ที่ส่งคืน และการเรียกใช้แบบอะซิงโครนัสพร้อม ID งานที่ส่งคืน หากใช้การเรียกใช้แบบซิงโครนัส ขั้นตอนที่ 4 และ 5 ถัดไปก็ไม่จำเป็น
4. ตรวจสอบสถานะงาน จนกว่าจะเสร็จสมบูรณ์ URL ดาวน์โหลดสไลด์ที่สร้างขึ้นจะถูกระบุ
5. ดาวน์โหลดงานนำเสนอของคุณ โดยใช้ URL ดาวน์โหลดที่ให้มา

การตรวจสอบสิทธิ์ (Authentication)

เอนด์พอยต์ API ทั้งหมดต้องมีการตรวจสอบสิทธิ์โดยใช้ API key คุณสามารถจัดการ API key ของคุณผ่าน อินเทอร์เฟซการจัดการ API

รูปแบบ API Key

API key มีรูปแบบดังนี้:

sk-2slides-{64-character-hex-string}

วิธีการตรวจสอบสิทธิ์

ส่วนหัวการอนุญาต (Authorization Header)

Authorization: Bearer sk-2slides-your-api-key-here

การจัดการ API Key

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

⚠️ ประกาศสำคัญด้านความปลอดภัย: แพลตฟอร์ม 2slides จะไม่จัดเก็บ API key ของคุณในรูปแบบข้อความธรรมดา (plaintext) ด้วยเหตุผลด้านความปลอดภัย เมื่อสร้างแล้ว คุณต้องคัดลอกและจัดเก็บ API key ของคุณอย่างปลอดภัยทันที หากคุณทำ API key หาย คุณจะต้องสร้างคีย์ใหม่เนื่องจากไม่สามารถกู้คืนคีย์เดิมได้

API Endpoints

1. สร้างสไลด์ (Fast PPT)

สร้างสไลด์ (Fast PPT) จากข้อความอินพุตโดยใช้ธีมเฉพาะ

Endpoint:

Headers:

Authorization: Bearer sk-2slides-your-api-key-here
Content-Type: application/json

Request Body:

{
  "userInput": "Your presentation content here...",
  "themeId": "theme-uuid-here",
  "responseLanguage": "Auto"
}

Parameters:

• userInput
  (จำเป็น): เนื้อหาที่คุณต้องการสร้างสไลด์
• themeId
  (จำเป็น): ID ของธีมที่จะใช้สำหรับการสร้างสไลด์ ซึ่งสามารถเป็น:
  • ธีมสาธารณะจาก แกลเลอรีเทมเพลต
  • ธีมที่คุณอัปโหลดเอง (เข้าถึงได้ผ่านบัญชีของคุณ)
• responseLanguage
  (ไม่จำเป็น): ภาษาสำหรับสไลด์ที่สร้างขึ้น ใช้ "Auto" สำหรับการตรวจจับอัตโนมัติ
• mode
  (ไม่จำเป็น): การเรียกใช้แบบซิงโครนัส (sync) หรืออะซิงโครนัส (async), "sync" เป็นค่าเริ่มต้น

ภาษาที่ใช้ได้:

• Auto
  - ตรวจจับภาษาจากข้อมูลนำเข้าโดยอัตโนมัติ (ค่าเริ่มต้น)
• English
  - อังกฤษ
• Simplified Chinese
  - จีนตัวย่อ
• Traditional Chinese
  - จีนตัวเต็ม
• Spanish
  - สเปน
• Arabic
  - อาหรับ
• Portuguese
  - โปรตุเกส
• Indonesian
  - อินโดนีเซีย
• Japanese
  - ญี่ปุ่น
• Russian
  - รัสเซีย
• Hindi
  - ฮินดี
• French
  - ฝรั่งเศส
• German
  - เยอรมัน
• Vietnamese
  - เวียดนาม
• Turkish
  - ตุรกี
• Polish
  - โปแลนด์
• Italian
  - อิตาลี
• Korean
  - เกาหลี

Response ในโหมด async:

{
  "success": true,
  "data": {
    "jobId": "job-uuid-here",
    "status": "processing",
    "message": "Slides generation started. Use the jobId to check status.",
    "credits": {
      "current": 150,
      "required": 30
    }
  }
}

Response ในโหมด sync:

{
  "success": true,
  "data": {
    "jobId": "1pFqIww3JjquQ1T3Ysmw1",
    "status": "success",
    "message": "Slides generated successfully",
    "downloadUrl": "https://presigned-url-here",
    "createdAt": 1760347015388,
    "updatedAt": 1760347048261,
    "duration": 32694,
    "slidePageCount": 9
  }
}

2. ตรวจสอบสถานะงาน (Fast PPT)

ตรวจสอบสถานะของงานสร้างสไลด์ (Fast PPT) และรับผลลัพธ์เมื่อเสร็จสมบูรณ์

Endpoint:

Headers:

Authorization: Bearer sk-2slides-your-api-key-here

ตัวอย่าง Response:

กำลังดำเนินการ (Processing):

{
  "success": true,
  "data": {
    "jobId": "job-uuid-here",
    "status": "processing",
    "message": "Slides generation in progress",
    "createdAt": 1703123456789,
    "updatedAt": 1703123460000
  }
}

สำเร็จ (Success):

{
  "success": true,
  "data": {
    "jobId": "job-uuid-here",
    "status": "success",
    "message": "Slides generated successfully",
    "downloadUrl": "https://presigned-url-here",
    "createdAt": 1703123456789,
    "updatedAt": 1703123500000,
    "duration": 33211,
    "slidePageCount": 3
  }
}

ล้มเหลว (Failed):

{
  "success": true,
  "data": {
    "jobId": "job-uuid-here",
    "status": "failed",
    "message": "Slides generation failed",
    "errorMessage": "Insufficient credits for generation",
    "createdAt": 1703123456789,
    "updatedAt": 1703123460000
  }
}

3. สร้างสไลด์แบบนี้ (Nano Banana Pro)

สร้างสไลด์ (Nano Banana Pro) จากรูปภาพอ้างอิง เอนด์พอยต์นี้ใช้โหมดซิงโครนัสและสร้าง PDF โดยอัตโนมัติเมื่อสไลด์ทั้งหมดเสร็จสมบูรณ์

Endpoint:

Headers:

Authorization: Bearer sk-2slides-your-api-key-here
Content-Type: application/json

Request Body:

{
  "userInput": "Your presentation content here...",
  "referenceImageUrl": "https://example.com/reference-image.jpg",
  "responseLanguage": "Auto",
  "aspectRatio": "16:9",
  "resolution": "2K",
  "page": 1
}

Parameters:

• userInput
  (จำเป็น): เนื้อหาที่คุณต้องการสร้างสไลด์
• referenceImageUrl
  (จำเป็น): URL ของรูปภาพอ้างอิงเพื่อใช้สไตล์การออกแบบ รองรับ:
  • HTTP/HTTPS URLs
  • Base64 data URLs (data:image/...)
• responseLanguage
  (ไม่จำเป็น): ภาษาสำหรับสไลด์ที่สร้างขึ้น ใช้ "Auto" สำหรับการตรวจจับอัตโนมัติ (ค่าเริ่มต้น: "Auto")
• aspectRatio
  (ไม่จำเป็น): อัตราส่วนภาพสำหรับสไลด์ รูปแบบ: "width:height" (ค่าเริ่มต้น: "16:9")
• resolution
  (ไม่จำเป็น): ความละเอียดสำหรับรูปภาพสไลด์ ตัวเลือก: "1K", "2K", "4K" (ค่าเริ่มต้น: "2K")
• page
  (ไม่จำเป็น): จำนวนสไลด์ที่จะสร้าง ใช้ 0 สำหรับการตรวจจับอัตโนมัติ ระบุตัวเลข (>=1, สูงสุด: 100) เพื่อบังคับจำนวนสไลด์นั้น ค่าเริ่มต้น: 1
• contentDetail
  (ไม่จำเป็น): ระดับรายละเอียดเนื้อหาสำหรับสไลด์ ตัวเลือก: "concise" (กระชับ, เน้นคีย์เวิร์ด) หรือ "standard" (ครอบคลุม, มีรายละเอียด) ค่าเริ่มต้น: "concise"

Response:

{
  "success": true,
  "data": {
    "jobId": "job-uuid-here",
    "status": "success",
    "message": "Successfully generated 5 slides",
    "downloadUrl": "https://presigned-url-to-pdf.pdf",
    "jobUrl": "https://2slides.com/workspace?jobId=job-uuid-here",
    "createdAt": 1703123456789,
    "updatedAt": 1703123500000,
    "slidePageCount": 5,
    "successCount": 5,
    "failedCount": 0
  }
}

ค่าสถานะ (Status Values):

• success
  : สไลด์ทั้งหมดสร้างสำเร็จ, มี PDF ให้ใช้งาน
• partial
  : สไลด์บางส่วนสร้างไม่สำเร็จ
• failed
  : สไลด์ทั้งหมดสร้างไม่สำเร็จ

หมายเหตุ: เอนด์พอยต์นี้ทำงานในโหมดซิงโครนัสและจะรอให้สไลด์ทั้งหมดสร้างเสร็จก่อนที่จะส่งคืนผลลัพธ์

4. ค้นหาธีม (Fast PPT)

ค้นหาธีมสไลด์ที่มีอยู่ (Fast PPT) ด้วยคีย์เวิร์ด ซึ่งรวมถึงทั้งธีมสาธารณะและธีมที่คุณอัปโหลดเอง

Endpoint:

Headers:

Authorization: Bearer sk-2slides-your-api-key-here

Query Parameters:

• query
  (จำเป็น): คีย์เวิร์ดสำหรับค้นหาในชื่อธีม, คำอธิบาย และแท็ก
• limit
  (ไม่จำเป็น): จำนวนผลลัพธ์สูงสุด (1-100, ค่าเริ่มต้น 20)

ตัวอย่างคำขอ:

GET /api/v1/themes/search?query=timeline&limit=10

Response:

{
  "success": true,
  "data": {
    "total": 25,
    "themes": [
      {
        "id": "theme-uuid-1",
        "name": "Modern Timeline",
        "description": "Clean and modern timeline template for project presentations",
        "tags": "timeline, modern, project, clean",
        "themeURL": "https://2slides.com/templates/st-1759917935785-nx0z6ae54"
      },
      {
        "id": "theme-uuid-2",
        "name": "Business Roadmap",
        "description": "Professional roadmap template for business planning",
        "tags": "roadmap, business, planning, professional",
        "themeURL": "https://2slides.com/templates/st-1755509077270-sftfm616s"
      }
    ]
  }
}

การจำกัดอัตราการเรียกใช้ (Rate Limiting)

API ใช้การจำกัดอัตราการเรียกใช้เพื่อให้แน่ใจว่ามีการใช้งานที่เป็นธรรมและระบบมีเสถียรภาพ เอนด์พอยต์ที่แตกต่างกันมีการจำกัดอัตราการเรียกใช้ที่แตกต่างกัน:

ส่วนหัวการจำกัดอัตรา (Rate Limit Headers)

เมื่อเกินขีดจำกัดอัตราการเรียกใช้ API จะส่งคืนการตอบสนอง

พร้อมส่วนหัวเหล่านี้:

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 6
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1703123600
Retry-After: 45

การจัดการการจำกัดอัตรา (Handling Rate Limits)

คุณต้องจัดการการจำกัดอัตราการเรียกใช้ API อย่างระมัดระวัง นี่คือตัวอย่างใน Javascript

async function makeApiRequest(url, options) {
  try {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      console.log(`Rate limited. Retry after ${retryAfter} seconds`);
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      return makeApiRequest(url, options); // Retry
    }
    
    return response;
  } catch (error) {
    console.error('API request failed:', error);
    throw error;
  }
}

ระบบเครดิต (Credit System)

2slides ใช้ระบบเครดิตสำหรับการสร้างสไลด์ แต่ละหน้าสไลด์มีค่าใช้จ่าย 10 เครดิต

กฎเครดิต

• ผู้ใช้ใหม่: ได้รับ 880 เครดิตฟรีเมื่อลงทะเบียน
• ค่าใช้จ่าย: 10 เครดิตต่อหน้าสไลด์ (Fast PPT), 100 เครดิตต่อ 1K/2K Nano Banana Pro สไลด์, 200 เครดิตต่อ 4K Nano Banana Pro สไลด์
• ขั้นต่ำ: ผู้ใช้ต้องมีเครดิตอย่างน้อย 10 เครดิตเพื่อเริ่มการสร้าง
• การหัก: เครดิตจะถูกหักหลังจากสร้างสำเร็จเท่านั้น
• การคืนเงิน: เครดิตจะถูกคืนเงินหากการสร้างล้มเหลว

การตรวจสอบเครดิต

คุณสามารถตรวจสอบยอดเครดิตของคุณผ่าน แดชบอร์ดบัญชี หรือโดยการตรวจสอบข้อมูลเครดิตในการตอบสนองของ API

การซื้อเครดิต

สามารถซื้อเครดิตเพิ่มเติมได้ผ่าน หน้าการกำหนดราคา โดยใช้วิธีการชำระเงินที่หลากหลาย

ตัวอย่าง

ตัวอย่างขั้นตอนการทำงานที่สมบูรณ์

นี่คือตัวอย่างที่สมบูรณ์ของการสร้างสไลด์โดยใช้ 2slides API ใน Javascript และ Python:

const API_KEY = 'sk-2slides-your-api-key-here';
const BASE_URL = 'https://2slides.com';

async function generateSlides() {
  try {
    // Step 1: Search for a theme
    const themeResponse = await fetch(
      `${BASE_URL}/api/v1/themes/search?query=timeline&limit=5`,
      {
        headers: {
          'Authorization': `Bearer ${API_KEY}`,
          'Content-Type': 'application/json'
        }
      }
    );
    
    const themeData = await themeResponse.json();
    const themeId = themeData.data.themes[0].id;
    
    // Step 2: Generate slides
    const generateResponse = await fetch(
      `${BASE_URL}/api/v1/slides/generate`,
      {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${API_KEY}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          userInput: "Create a timeline for our product development: Q1 - Research and planning, Q2 - MVP development, Q3 - Beta testing, Q4 - Public launch",
          themeId: themeId,
          responseLanguage: "English",
          mode: "async"
        })
      }
    );
    
    const generateData = await generateResponse.json();
    const jobId = generateData.data.jobId;
    
    // Step 3: Poll for completion
    let jobStatus;
    do {
      await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
      
      const statusResponse = await fetch(
        `${BASE_URL}/api/v1/jobs/${jobId}`,
        {
          headers: {
            'Authorization': `Bearer ${API_KEY}`
          }
        }
      );
      
      jobStatus = await statusResponse.json();
      console.log(`Status: ${jobStatus.data.status}`);
      
    } while (jobStatus.data.status === 'processing' || jobStatus.data.status === 'pending');
    
    // Step 4: Handle result
    if (jobStatus.data.status === 'success') {
      console.log('Slides generated successfully!');
      console.log('Download URL:', jobStatus.data.downloadUrl);
      console.log('Pages generated:', jobStatus.data.slidePageCount);
      
      // Download the file
      const downloadResponse = await fetch(jobStatus.data.downloadUrl);
      const blob = await downloadResponse.blob();
      
      // Create download link
      const url = window.URL.createObjectURL(blob);
      const a = document.createElement('a');
      a.href = url;
      a.download = 'presentation.pptx';
      a.click();
      window.URL.revokeObjectURL(url);
      
    } else {
      console.error('Generation failed:', jobStatus.data.errorMessage);
    }
    
  } catch (error) {
    console.error('Error:', error);
  }
}

// Run the example
generateSlides();

ตัวอย่าง Python

import requests
import time
import json

API_KEY = 'sk-2slides-your-api-key-here'
BASE_URL = 'https://2slides.com'

def generate_slides():
    headers = {
        'Authorization': f'Bearer {API_KEY}',
        'Content-Type': 'application/json'
    }
    
    try:
        # Step 1: Search for a theme
        theme_response = requests.get(
            f'{BASE_URL}/api/v1/themes/search',
            params={'query': 'roadmap', 'limit': 5},
            headers=headers
        )
        theme_data = theme_response.json()
        theme_id = theme_data['data']['themes'][0]['id']
        
        # Step 2: Generate slides
        generate_payload = {
            'userInput': 'Create a product roadmap for our mobile app: Phase 1 - Core features, Phase 2 - Advanced features, Phase 3 - AI integration',
            'themeId': theme_id,
            'responseLanguage': 'English',
            'mode': 'async'
        }
        
        generate_response = requests.post(
            f'{BASE_URL}/api/v1/slides/generate',
            headers=headers,
            json=generate_payload
        )
        generate_data = generate_response.json()
        job_id = generate_data['data']['jobId']
        
        # Step 3: Poll for completion
        while True:
            time.sleep(2)  # Wait 2 seconds
            
            status_response = requests.get(
                f'{BASE_URL}/api/v1/jobs/{job_id}',
                headers=headers
            )
            status_data = status_response.json()
            status = status_data['data']['status']
            
            print(f'Status: {status}')
            
            if status in ['success', 'failed']:
                break
        
        # Step 4: Handle result
        if status == 'success':
            print('Slides generated successfully!')
            print(f'Download URL: {status_data["data"]["downloadUrl"]}')
            print(f'Pages generated: {status_data["data"]["slidePageCount"]}')
            
            # Download the file
            download_response = requests.get(status_data['data']['downloadUrl'])
            with open('presentation.pptx', 'wb') as f:
                f.write(download_response.content)
            print('File downloaded as presentation.pptx')
            
        else:
            print(f'Generation failed: {status_data["data"]["errorMessage"]}')
            
    except Exception as error:
        print(f'Error: {error}')

# Run the example
generate_slides()

ตัวอย่าง cURL

ค้นหาธีม:

curl -X GET "https://2slides.com/api/v1/themes/search?query=timeline&limit=5" \
  -H "Authorization: Bearer sk-2slides-your-api-key-here" \
  -H "Content-Type: application/json"

สร้างสไลด์:

curl -X POST "https://2slides.com/api/v1/slides/generate" \
  -H "Authorization: Bearer sk-2slides-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "userInput": "Create a timeline for our project milestones",
    "themeId": "theme-uuid-here",
    "responseLanguage": "English",
    "mode": "async"
  }'

ตรวจสอบสถานะงาน:

curl -X GET "https://2slides.com/api/v1/jobs/job-uuid-here" \
  -H "Authorization: Bearer sk-2slides-your-api-key-here"

การจัดการข้อผิดพลาด (Error Handling)

API ใช้รหัสสถานะ HTTP มาตรฐานและส่งคืนข้อมูลข้อผิดพลาดโดยละเอียดในรูปแบบ JSON

การตอบสนองข้อผิดพลาดทั่วไป

400 Bad Request:

{
  "success": false,
  "error": "userInput is required and must be a non-empty string"
}

401 Unauthorized:

{
  "success": false,
  "error": "Authentication required"
}

403 Forbidden:

{
  "success": false,
  "error": "Access denied"
}

404 Not Found:

{
  "success": false,
  "error": "Theme not found"
}

429 Too Many Requests:

{
  "success": false,
  "error": "Rate limit exceeded"
}

500 Internal Server Error:

{
  "success": false,
  "error": "Internal server error"
}

แนวทางปฏิบัติที่ดีที่สุดในการจัดการข้อผิดพลาด

async function handleApiRequest(url, options) {
  try {
    const response = await fetch(url, options);
    const data = await response.json();
    
    if (!response.ok) {
      switch (response.status) {
        case 400:
          throw new Error(`Bad Request: ${data.error}`);
        case 401:
          throw new Error('Authentication failed. Please check your API key.');
        case 403:
          throw new Error('Access denied. You may not have permission for this resource.');
        case 404:
          throw new Error('Resource not found.');
        case 429:
          throw new Error('Rate limit exceeded. Please try again later.');
        case 500:
          throw new Error('Server error. Please try again later.');
        default:
          throw new Error(`API Error: ${data.error || 'Unknown error'}`);
      }
    }
    
    return data;
  } catch (error) {
    if (error.name === 'TypeError' && error.message.includes('fetch')) {
      throw new Error('Network error. Please check your internet connection.');
    }
    throw error;
  }
}

แนวทางปฏิบัติที่ดีที่สุด (Best Practices)

1. ความปลอดภัยของ API Key

• ห้ามเปิดเผย API key ในโค้ดฝั่งไคลเอ็นต์หรือที่เก็บสาธารณะ
• ใช้ตัวแปรสภาพแวดล้อม เพื่อจัดเก็บ API key อย่างปลอดภัย
• หมุนเวียนคีย์เป็นประจำ เพื่อเพิ่มความปลอดภัย
• ตรวจสอบการใช้งานคีย์ ผ่าน แดชบอร์ดการจัดการ API
• จัดเก็บคีย์อย่างปลอดภัย: โปรดจำไว้ว่า 2slides ไม่ได้จัดเก็บ API key ของคุณ ดังนั้นคุณต้องเก็บรักษาไว้ให้ปลอดภัย
• สำรองข้อมูลคีย์ของคุณ: จัดเก็บ API key ในตัวจัดการรหัสผ่านที่ปลอดภัยหรือที่เก็บข้อมูลที่เข้ารหัส

2. การใช้งาน API อย่างมีประสิทธิภาพ

• แคชผลลัพธ์การค้นหาธีม เพื่อหลีกเลี่ยงการร้องขอซ้ำๆ
• กำหนดช่วงเวลาการตรวจสอบ (polling intervals) ที่เหมาะสม สำหรับการตรวจสอบสถานะงาน (2-5 วินาที)
• จัดการการจำกัดอัตราการเรียกใช้ (rate limits) อย่างเหมาะสม ด้วยการถอยกลับแบบเอ็กซ์โพเนนเชียล (exponential backoff)
• ดำเนินการแบบกลุ่ม (Batch operations) เมื่อเป็นไปได้เพื่อลดการเรียกใช้ API

3. การจัดการข้อผิดพลาด

• ตรวจสอบรหัสสถานะการตอบสนองเสมอ
• ใช้ตรรกะการลองใหม่ (retry logic) สำหรับความล้มเหลวชั่วคราว
• บันทึกข้อผิดพลาดอย่างเหมาะสม สำหรับการดีบัก
• จัดเตรียมข้อความแสดงข้อผิดพลาดที่เข้าใจง่ายสำหรับผู้ใช้

4. การเพิ่มประสิทธิภาพด้านประสิทธิภาพ

• ใช้ช่วงเวลาการตรวจสอบ (polling intervals) ที่เหมาะสม เพื่อหลีกเลี่ยงการร้องขอที่ไม่จำเป็น
• ใช้การหมดเวลาของคำขอ (request timeouts) เพื่อป้องกันคำขอค้าง
• แคชข้อมูลที่ใช้บ่อย เช่น ข้อมูลธีม
• ตรวจสอบการใช้เครดิตของคุณ เพื่อหลีกเลี่ยงค่าใช้จ่ายที่ไม่คาดคิด

5. แนวทางเนื้อหา

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

การสนับสนุนและแหล่งข้อมูล

เอกสารประกอบและแหล่งข้อมูล

• เอกสารประกอบ API - เอกสารประกอบ API แบบโต้ตอบและสนามทดลอง (playground)
• แกลเลอรีเทมเพลต - เรียกดูเทมเพลตสไลด์ที่มีอยู่
• ข้อมูลราคา - แพ็กเกจเครดิตและการกำหนดราคา
• บล็อก - อัปเดตและเคล็ดลับล่าสุด

การขอความช่วยเหลือ

• API Playground: ทดสอบการเรียกใช้ API ของคุณโดยตรงในเบราว์เซอร์ที่ 2slides.com/api
• Account Dashboard: จัดการการใช้เครดิตของคุณที่ 2slides.com/account
• Support: ติดต่อฝ่ายสนับสนุนผ่าน เว็บไซต์หลัก

ชุมชนและการอัปเดต

• การอัปเดตคุณสมบัติ: ติดตามคุณสมบัติและการปรับปรุงใหม่ๆ
• คลังเทมเพลต: เพิ่มเทมเพลตมืออาชีพใหม่ๆ เป็นประจำ
• การปรับปรุง API: การปรับปรุงประสิทธิภาพและคุณสมบัติของ API อย่างต่อเนื่อง

---

บทสรุป

2slides API มอบวิธีที่ทรงพลังและยืดหยุ่นในการสร้างงานนำเสนอระดับมืออาชีพด้วยโปรแกรม ด้วยชุดคุณสมบัติที่ครอบคลุม การจัดการข้อผิดพลาดที่แข็งแกร่ง และคลังเทมเพลตที่กว้างขวาง คุณสามารถผสานรวมการสร้างสไลด์ที่ขับเคลื่อนด้วย AI เข้ากับแอปพลิเคชันหรือเวิร์กโฟลว์ใดๆ ได้

เริ่มต้นสร้างงานนำเสนอที่น่าทึ่งวันนี้ด้วย 2slides API! เยี่ยมชม 2slides.com/api เพื่อรับ API key ของคุณและเริ่มต้นสร้างสรรค์