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

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

ภาพรวม

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

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

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

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

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

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

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

Base URL

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

https://2slides.com

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

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

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

รับ API key ของคุณ จาก หน้าการจัดการ API
ค้นหาธีม โดยใช้เอนด์พอยต์ค้นหาธีม หรือเรียกดู เทมเพลต เพื่อ รับ ID ธีมสไลด์
สร้างสไลด์ ด้วยเนื้อหาและ ID ธีมที่คุณเลือก ซึ่งรองรับทั้งการเรียกใช้แบบซิงโครนัสพร้อมสไลด์ผลลัพธ์ที่ส่งคืน และการเรียกใช้แบบอะซิงโครนัสพร้อม ID งานที่ส่งคืน หากใช้การเรียกใช้แบบซิงโครนัส ขั้นตอนที่ 4 และ 5 ถัดไปก็ไม่จำเป็น
ตรวจสอบสถานะงาน จนกว่าจะเสร็จสมบูรณ์ URL ดาวน์โหลดสไลด์ที่สร้างขึ้นจะถูกระบุ
ดาวน์โหลดงานนำเสนอของคุณ โดยใช้ 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: POST /api/v1/slides/generate

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: GET /api/v1/jobs/{jobId}

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: POST /api/v1/slides/create-like-this

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: GET /api/v1/themes/search

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

Endpoint	Time Window	Max Requests	Description
`/api/v1/slides/generate`	1 minute	6 requests	เอนด์พอยต์การสร้างหลัก
`/api/v1/slides/create-like-this`	1 minute	6 requests	สร้างสไลด์จากรูปภาพอ้างอิง
`/api/v1/jobs`	1 minute	10 requests	การตรวจสอบสถานะงาน
`/api/v1/themes/search`	1 minute	30 requests	การค้นหาธีม

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

เมื่อเกินขีดจำกัดอัตราการเรียกใช้ API จะส่งคืนการตอบสนอง 429 Too Many Requests พร้อมส่วนหัวเหล่านี้:

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 ของคุณและเริ่มต้นสร้างสรรค์

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

ภาพรวม

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

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

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

Base URL

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

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

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

รูปแบบ API Key

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

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

การจัดการ API Key

API Endpoints

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

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

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

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

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

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

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

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

กฎเครดิต

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

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

ตัวอย่าง

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

ตัวอย่าง Python

ตัวอย่าง cURL

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

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

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

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

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

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

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

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

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

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

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

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

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

บทสรุป

About 2Slides

Summarize with AI

Products

Features

Gallery

Templates

Integrations

Resources

Comparison