Οδηγός 2slides API - Πλήρης Οδηγός για Δημιουργία Παρουσιάσεων με AI

Καλώς ήρθατε στον πλήρη οδηγό για το 2slides API! Αυτό το σεμινάριο θα σας καθοδηγήσει σε όλα όσα πρέπει να γνωρίζετε για να ενσωματώσετε τη δημιουργία παρουσιάσεων με τεχνητή νοημοσύνη (AI) στις εφαρμογές σας.

Επισκόπηση

Το 2slides API σας επιτρέπει να δημιουργείτε επαγγελματικές παρουσιάσεις προγραμματιστικά χρησιμοποιώντας AI. Με υποστήριξη για πολλούς τύπους παρουσιάσεων, όπως χρονοδιαγράμματα (timelines), οδικούς χάρτες (roadmaps), εννοιολογικούς χάρτες (mind maps) και άλλα, μπορείτε να δημιουργήσετε εντυπωσιακές διαφάνειες από απλή εισαγωγή κειμένου.

Βασικά Χαρακτηριστικά

Δημιουργία με AI: Αυτόματη δημιουργία επαγγελματικών παρουσιάσεων από κείμενο
Πολλαπλοί Τύποι Προτύπων: Υποστήριξη για χρονοδιαγράμματα, οδικούς χάρτες, εννοιολογικούς χάρτες, pitch decks, infographics και άλλα
Υποστήριξη Πολλαπλών Γλωσσών: Δημιουργία περιεχομένου σε πολλές γλώσσες
Πλούσια Βιβλιοθήκη Προτύπων: Πρόσβαση σε εκατοντάδες επαγγελματικά σχεδιασμένα πρότυπα
Προσαρμοσμένα Πρότυπα: Ανεβάστε και χρησιμοποιήστε τα δικά σας προσαρμοσμένα πρότυπα διαφανειών
Αναζήτηση προτύπων: Αναζήτηση προτύπων μέσω ονόματος, λέξεων-κλειδιών και ετικετών
Επιλογές Λήψης: Λήψη παρουσιάσεων σε μορφή PowerPoint (.pptx)
Παρακολούθηση Κατάστασης σε Πραγματικό Χρόνο: Παρακολούθηση της προόδου δημιουργίας με endpoints κατάστασης εργασίας

Προτεινόμενοι Τύποι Παρουσιάσεων

Όλα τα πρότυπα παρουσιάσεων είναι διαθέσιμα εδώ: 2slides Templates. Συγκεκριμένα, υπάρχουν ορισμένοι προτεινόμενοι τύποι παρουσιάσεων που λειτουργούν πολύ καλά για συγκεκριμένους σκοπούς και σενάρια.

Διαφάνειες Χρονοδιαγράμματος (Timeline Slides) - Ιδανικές για χρονοδιαγράμματα έργων και ιστορικά γεγονότα
Διαφάνειες Οδικού Χάρτη (Roadmap Slides) - Ιδανικές για οδικούς χάρτες προϊόντων και προγραμματισμό έργων
Διαφάνειες Εννοιολογικού Χάρτη (Mind Map Slides) - Εξαιρετικές για χαρτογράφηση εννοιών και δομή γνώσης

Ξεκινώντας

Βασική Διεύθυνση URL

Όλες οι αιτήσεις API πρέπει να γίνονται στη διεύθυνση:

https://2slides.com

Προαπαιτούμενα

Δημιουργία Λογαριασμού: Δημιουργήστε έναν λογαριασμό στο 2slides.com
Κλειδί API: Δημιουργήστε ένα κλειδί API από τη σελίδα διαχείρισης API
Πιστώσεις (Credits): Βεβαιωθείτε ότι έχετε επαρκείς πιστώσεις για τη δημιουργία διαφανειών (10 πιστώσεις ανά σελίδα διαφάνειας)

Γρήγορη Εκκίνηση

Αποκτήστε το κλειδί API σας από τη σελίδα διαχείρισης API
Αναζητήστε ένα θέμα χρησιμοποιώντας το endpoint αναζήτησης θεμάτων, ή περιηγηθείτε στα πρότυπα για να λάβετε το αναγνωριστικό θέματος διαφάνειας
Δημιουργήστε διαφάνειες με το περιεχόμενό σας και το επιλεγμένο αναγνωριστικό θέματος. Αυτό υποστηρίζει τόσο σύγχρονη κλήση με επιστρεφόμενες διαφάνειες αποτελεσμάτων όσο και ασύγχρονη κλήση με επιστρεφόμενο αναγνωριστικό εργασίας. Εάν χρησιμοποιείτε σύγχρονη κλήση, τότε τα επόμενα βήματα 4 και 5 δεν είναι απαραίτητα.
Ελέγξτε την κατάσταση εργασίας μέχρι την ολοκλήρωση. Θα παρασχεθεί η διεύθυνση URL λήψης των δημιουργημένων διαφανειών.
Κατεβάστε την παρουσίασή σας χρησιμοποιώντας την παρεχόμενη διεύθυνση URL λήψης.

Αυθεντικοποίηση

Όλα τα endpoints του API απαιτούν αυθεντικοποίηση χρησιμοποιώντας ένα κλειδί API. Μπορείτε να διαχειριστείτε τα κλειδιά API σας μέσω της διεπαφής διαχείρισης API.

Μορφή Κλειδιού API

Τα κλειδιά API ακολουθούν αυτή τη μορφή:

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

Μέθοδοι Αυθεντικοποίησης

Επικεφαλίδα Εξουσιοδότησης (Authorization Header)

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

Διαχείριση Κλειδιών API

Μέγιστος Αριθμός Κλειδιών: Κάθε χρήστης μπορεί να δημιουργήσει έως και 10 κλειδιά API
Ονομασία Κλειδιών: Δώστε στα κλειδιά σας περιγραφικά ονόματα για εύκολη αναγνώριση
Ασφάλεια: Διατηρήστε τα κλειδιά API σας ασφαλή και μην τα μοιράζεστε ποτέ δημόσια
Περιστροφή (Rotation): Περιστρέφετε τακτικά τα κλειδιά API σας για βελτιωμένη ασφάλεια

⚠️ Σημαντική Σημείωση Ασφαλείας: Η πλατφόρμα 2slides ΔΕΝ αποθηκεύει τα κλειδιά API σας σε απλό κείμενο για λόγους ασφαλείας. Μόλις δημιουργηθεί, πρέπει να αντιγράψετε και να αποθηκεύσετε με ασφάλεια το κλειδί API σας αμέσως. Εάν χάσετε το κλειδί API σας, θα χρειαστεί να δημιουργήσετε ένα νέο, καθώς το αρχικό δεν μπορεί να ανακτηθεί.

Endpoints API

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"
}

Παράμετροι:

userInput
(απαιτούμενο): Το περιεχόμενο για το οποίο θέλετε να δημιουργήσετε διαφάνειες
themeId
(απαιτούμενο): Αναγνωριστικό του θέματος που θα χρησιμοποιηθεί για τη δημιουργία διαφανειών. Αυτό μπορεί να είναι:
- Δημόσια θέματα από τη συλλογή προτύπων
- Τα δικά σας προσαρμοσμένα θέματα που έχετε ανεβάσει (προσβάσιμα μέσω του λογαριασμού σας)
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
- Κορεατικά

Απόκριση σε ασύγχρονη λειτουργία:

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

Απόκριση σε σύγχρονη λειτουργία:

{
  "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

Παραδείγματα Απόκρισης:

Επεξεργασία (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) από μια εικόνα αναφοράς. Αυτό το endpoint χρησιμοποιεί σύγχρονη λειτουργία και δημιουργεί αυτόματα ένα 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
}

Παράμετροι:

userInput
(απαιτούμενο): Το περιεχόμενο για το οποίο θέλετε να δημιουργήσετε διαφάνειες
referenceImageUrl
(απαιτούμενο): URL της εικόνας αναφοράς για να ακολουθήσετε το στυλ σχεδίασης. Υποστηρίζει:
- URLs HTTP/HTTPS
- URLs δεδομένων Base64 (data:image/...)
responseLanguage
(προαιρετικό): Γλώσσα για τις δημιουργημένες διαφάνειες. Χρησιμοποιήστε "Auto" για αυτόματη ανίχνευση (προεπιλογή: "Auto")
aspectRatio
(προαιρετικό): Αναλογία διαστάσεων για τις διαφάνειες. Μορφή: "πλάτος:ύψος" (προεπιλογή: "16:9")
resolution
(προαιρετικό): Ανάλυση για τις εικόνες διαφανειών. Επιλογές: "1K", "2K", "4K" (προεπιλογή: "2K")
page
(προαιρετικό): Αριθμός διαφανειών προς δημιουργία. Χρησιμοποιήστε 0 για αυτόματη ανίχνευση. Καθορίστε έναν αριθμό (>=1, μέγιστο: 100) για να επιβάλετε αυτόν τον αριθμό διαφανειών. Προεπιλογή: 1.
contentDetail
(προαιρετικό): Επίπεδο λεπτομέρειας περιεχομένου για τις διαφάνειες. Επιλογές: "concise" (σύντομο, εστιασμένο σε λέξεις-κλειδιά) ή "standard" (περιεκτικό, λεπτομερές). Προεπιλογή: "concise".

Απόκριση:

{
  "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
  }
}

Τιμές Κατάστασης:

success
: Όλες οι διαφάνειες δημιουργήθηκαν επιτυχώς, το PDF είναι διαθέσιμο
partial
: Ορισμένες διαφάνειες απέτυχαν να δημιουργηθούν
failed
: Όλες οι διαφάνειες απέτυχαν να δημιουργηθούν

Σημείωση: Αυτό το endpoint λειτουργεί σε σύγχρονη λειτουργία και θα περιμένει να δημιουργηθούν όλες οι διαφάνειες πριν επιστρέψει.

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

Απόκριση:

{
  "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 εφαρμόζει περιορισμό ρυθμού για να διασφαλίσει τη δίκαιη χρήση και τη σταθερότητα του συστήματος. Διαφορετικά endpoints έχουν διαφορετικά όρια ρυθμού:

Endpoint	Χρονικό Παράθυρο	Μέγιστες Αιτήσεις	Περιγραφή
`/api/v1/slides/generate`	1 λεπτό	6 αιτήσεις	Βασικό endpoint δημιουργίας
`/api/v1/slides/create-like-this`	1 λεπτό	6 αιτήσεις	Δημιουργία διαφανειών από εικόνα αναφοράς
`/api/v1/jobs`	1 λεπτό	10 αιτήσεις	Έλεγχος κατάστασης εργασίας
`/api/v1/themes/search`	1 λεπτό	30 αιτήσεις	Αναζήτηση θεμάτων

Επικεφαλίδες Περιορισμού Ρυθμού (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

Διαχείριση Περιορισμών Ρυθμού

Πρέπει να διαχειριστείτε προσεκτικά τον περιορισμό ρυθμού κλήσεων 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"

Διαχείριση Σφαλμάτων

Το 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;
  }
}

Βέλτιστες Πρακτικές

1. Ασφάλεια Κλειδιού API

Ποτέ μην εκθέτετε τα κλειδιά API σε κώδικα client-side ή δημόσια αποθετήρια
Χρησιμοποιήστε μεταβλητές περιβάλλοντος για την ασφαλή αποθήκευση κλειδιών API
Περιστρέφετε τα κλειδιά τακτικά για βελτιωμένη ασφάλεια
Παρακολουθείτε τη χρήση κλειδιών μέσω του πίνακα ελέγχου διαχείρισης API
Αποθηκεύστε τα κλειδιά με ασφάλεια: Να θυμάστε ότι το 2slides δεν αποθηκεύει τα κλειδιά API σας, οπότε πρέπει να τα διατηρείτε ασφαλή
Δημιουργήστε αντίγραφα ασφαλείας των κλειδιών σας: Αποθηκεύστε τα κλειδιά API σε έναν ασφαλή διαχειριστή κωδικών πρόσβασης ή κρυπτογραφημένο χώρο αποθήκευσης

2. Αποτελεσματική Χρήση API

Αποθηκεύστε προσωρινά (cache) τα αποτελέσματα αναζήτησης θεμάτων για να αποφύγετε επαναλαμβανόμενες αιτήσεις
Εφαρμόστε κατάλληλα διαστήματα polling για ελέγχους κατάστασης εργασίας (2-5 δευτερόλεπτα)
Διαχειριστείτε τους περιορισμούς ρυθμού με χάρη με εκθετική αναμονή (exponential backoff)
Ομαδοποιήστε λειτουργίες όταν είναι δυνατόν για να μειώσετε τις κλήσεις API

3. Διαχείριση Σφαλμάτων

Πάντα να ελέγχετε τους κωδικούς κατάστασης απόκρισης
Εφαρμόστε λογική επανάληψης για παροδικές αποτυχίες
Καταγράψτε τα σφάλματα κατάλληλα για εντοπισμό σφαλμάτων (debugging)
Παρέχετε φιλικά προς τον χρήστη μηνύματα σφαλμάτων

4. Βελτιστοποίηση Απόδοσης

Χρησιμοποιήστε κατάλληλα διαστήματα polling για να αποφύγετε περιττές αιτήσεις
Εφαρμόστε timeouts αιτήσεων για να αποτρέψετε αιτήσεις που "κολλάνε"
Αποθηκεύστε προσωρινά (cache) συχνά χρησιμοποιούμενα δεδομένα όπως πληροφορίες θεμάτων
Παρακολουθείτε τη χρήση των πιστώσεών σας για να αποφύγετε απροσδόκητες χρεώσεις

5. Οδηγίες Περιεχομένου

Παρέχετε σαφή, δομημένη εισαγωγή για καλύτερη δημιουργία διαφανειών
Χρησιμοποιήστε κατάλληλα θέματα για τον τύπο περιεχομένου σας
Καθορίστε τη γλώσσα όταν χρειάζεται για διεθνές περιεχόμενο
Διατηρήστε το περιεχόμενο συνοπτικό για βέλτιστη διάταξη διαφανειών

Υποστήριξη & Πόροι

Τεκμηρίωση & Πόροι

Τεκμηρίωση API - Διαδραστική τεκμηρίωση API και playground
Συλλογή Προτύπων - Περιηγηθείτε στα διαθέσιμα πρότυπα διαφανειών
Πληροφορίες Τιμολόγησης - Πακέτα πιστώσεων και τιμολόγηση
Blog - Τελευταίες ενημερώσεις και συμβουλές

Λήψη Βοήθειας

API Playground: Δοκιμάστε τις κλήσεις API σας απευθείας στον browser στο 2slides.com/api
Πίνακας Ελέγχου Λογαριασμού: Διαχειριστείτε τη χρήση των πιστώσεών σας στο 2slides.com/account
Υποστήριξη: Επικοινωνήστε με την υποστήριξη μέσω της κύριας ιστοσελίδας

Κοινότητα & Ενημερώσεις

Ενημερώσεις Λειτουργιών: Μείνετε ενήμεροι για νέες λειτουργίες και βελτιώσεις
Βιβλιοθήκη Προτύπων: Τακτικές προσθήκες νέων επαγγελματικών προτύπων
Βελτιώσεις API: Συνεχείς βελτιώσεις στην απόδοση και τις λειτουργίες του API

Συμπέρασμα

Το 2slides API παρέχει έναν ισχυρό και ευέλικτο τρόπο για τη δημιουργία επαγγελματικών παρουσιάσεων προγραμματιστικά. Με το ολοκληρωμένο σύνολο λειτουργιών του, την ισχυρή διαχείριση σφαλμάτων και την εκτενή βιβλιοθήκη προτύπων, μπορείτε να ενσωματώσετε τη δημιουργία διαφανειών με AI σε οποιαδήποτε εφαρμογή ή ροή εργασίας.

Ξεκινήστε να δημιουργείτε εκπληκτικές παρουσιάσεις σήμερα με το 2slides API! Επισκεφθείτε το 2slides.com/api για να αποκτήσετε το κλειδί API σας και να ξεκινήσετε τη δημιουργία.

Οδηγός 2slides API - Πλήρης Οδηγός για Δημιουργία Παρουσιάσεων με AI

Επισκόπηση

Βασικά Χαρακτηριστικά

Προτεινόμενοι Τύποι Παρουσιάσεων

Ξεκινώντας

Βασική Διεύθυνση URL

Προαπαιτούμενα

Γρήγορη Εκκίνηση

Αυθεντικοποίηση

Μορφή Κλειδιού API

Μέθοδοι Αυθεντικοποίησης

Επικεφαλίδα Εξουσιοδότησης (Authorization Header)

Διαχείριση Κλειδιών API

Endpoints API

1. Δημιουργία Διαφανειών (Fast PPT)

2. Έλεγχος Κατάστασης Εργασίας (Fast PPT)

3. Δημιουργία Διαφανειών Όπως Αυτή (Nano Banana Pro)

4. Αναζήτηση Θεμάτων (Fast PPT)

Περιορισμός Ρυθμού (Rate Limiting)

Επικεφαλίδες Περιορισμού Ρυθμού (Rate Limit Headers)

Διαχείριση Περιορισμών Ρυθμού

Σύστημα Πιστώσεων (Credit System)

Κανόνες Πιστώσεων

Έλεγχος Πιστώσεων

Αγορά Πιστώσεων

Παραδείγματα

Παράδειγμα Πλήρους Ροής Εργασίας

Παράδειγμα Python

Παραδείγματα cURL

Διαχείριση Σφαλμάτων

Κοινές Αποκρίσεις Σφαλμάτων

Βέλτιστες Πρακτικές Διαχείρισης Σφαλμάτων

Βέλτιστες Πρακτικές

1. Ασφάλεια Κλειδιού API

2. Αποτελεσματική Χρήση API

3. Διαχείριση Σφαλμάτων

4. Βελτιστοποίηση Απόδοσης

5. Οδηγίες Περιεχομένου

Υποστήριξη & Πόροι

Τεκμηρίωση & Πόροι

Λήψη Βοήθειας

Κοινότητα & Ενημερώσεις

Συμπέρασμα

About 2Slides

Summarize with AI

Products

Features

Gallery

Templates

Resources

Comparison