Αυτοματοποιήστε τη Δημιουργία Παρουσιάσεων με Python: Οδηγός API 2Slides

Η Python είναι η προτιμώμενη γλώσσα για αυτοματισμό, data pipelines και AI workflows. Αυτός ο οδηγός σας δείχνει πώς να χρησιμοποιήσετε το REST API του 2Slides από την Python για να δημιουργήσετε παρουσιάσεις αυτόματα — από απλές μεμονωμένες διαφάνειες έως πολύπλοκα αυτοματοποιημένα συστήματα.

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

pip install requests python-dotenv

Δημιουργήστε ένα αρχείο

:

TWOSLIDES_API_KEY=sk-2slides-your-api-key

Γρήγορη Εκκίνηση: Δημιουργήστε τις Πρώτες σας Διαφάνειες

import os
import time
import requests
from dotenv import load_dotenv

load_dotenv()

API_KEY = os.getenv('TWOSLIDES_API_KEY')
BASE_URL = 'https://2slides.com/api/v1'
HEADERS = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

def generate_slides(topic, theme_id=None, mode='async'):
    """Δημιουργία παρουσίασης από ένα κείμενο θέματος."""
    payload = {
        'userInput': topic,
        'mode': mode,
        'responseLanguage': 'en',
        'resolution': '2K',
    }
    if theme_id:
        payload['themeId'] = theme_id

    response = requests.post(
        f'{BASE_URL}/slides/generate',
        headers=HEADERS,
        json=payload
    )
    response.raise_for_status()
    return response.json()

def wait_for_job(job_id, timeout=300, interval=3):
    """Έλεγχος μέχρι να ολοκληρωθεί μια εργασία."""
    start = time.time()
    while time.time() - start < timeout:
        response = requests.get(
            f'{BASE_URL}/jobs/{job_id}',
            headers=HEADERS
        )
        data = response.json()
        status = data.get('status')
        print(f'  Εργασία {job_id}: {status}')

        if status == 'success':
            return data
        if status == 'failed':
            raise Exception(f'Η εργασία απέτυχε: {data}')

        time.sleep(interval)
    raise TimeoutError(f'Η εργασία {job_id} έληξε μετά από {timeout}s')

# Δημιουργία παρουσίασης
job = generate_slides('Οι 10 Κορυφαίες Τάσεις AI για το 2026')
print(f'Job ID: {job["jobId"]}')

result = wait_for_job(job['jobId'])
print(f'Λήψη: {result["downloadUrl"]}')

Μετατροπή Εγγράφων σε Διαφάνειες

def convert_file_to_slides(file_url, prompt='', theme_id=None):
    """Μετατροπή PDF, DOCX, XLSX ή άλλων αρχείων σε διαφάνειες."""
    payload = {
        'fileUrl': file_url,
        'userInput': prompt,
        'mode': 'async'
    }
    if theme_id:
        payload['themeId'] = theme_id

    response = requests.post(
        f'{BASE_URL}/slides/create-pdf-slides',
        headers=HEADERS,
        json=payload
    )
    response.raise_for_status()
    job = response.json()
    return wait_for_job(job['jobId'])

# Μετατροπή αναφοράς τριμήνου σε PDF
result = convert_file_to_slides(
    file_url='https://your-storage.com/q1-report.pdf',
    prompt='Εκτελεστική περίληψη για το διοικητικό συμβούλιο, μέγιστο 10 διαφάνειες'
)
print(f'Λήψη: {result["downloadUrl"]}')

Διαφάνειες με Ταιριαστό Σχεδιασμό (Δημιουργία Όπως Αυτό)

def create_like_this(topic, reference_image_url, resolution='2K'):
    """Δημιουργήστε διαφάνειες που ταιριάζουν με έναν σχεδιασμό αναφοράς."""
    payload = {
        'userInput': topic,
        'designStyle': {
            'global': {
                'referenceImageUrl': reference_image_url
            }
        },
        'resolution': resolution,
        'mode': 'async'
    }

    response = requests.post(
        f'{BASE_URL}/slides/create-like-this',
        headers=HEADERS,
        json=payload
    )
    response.raise_for_status()
    job = response.json()
    return wait_for_job(job['jobId'])

# Ταιριάξτε το πρότυπο της επωνυμίας σας
result = create_like_this(
    topic='Μηνιαία Ενημέρωση Ομάδας — Μάρτιος 2026',
    reference_image_url='https://your-brand.com/slide-template.png'
)

Προσθήκη Φωνητικής Αφήγησης

def add_narration(job_id, mode='single', voice='Charon', content_mode='concise'):
    """Προσθέστε φωνητική αφήγηση AI σε υπάρχουσες διαφάνειες."""
    payload = {
        'jobId': job_id,
        'mode': mode,
        'voice': voice,
        'contentMode': content_mode
    }

    response = requests.post(
        f'{BASE_URL}/slides/generate-narration',
        headers=HEADERS,
        json=payload
    )
    response.raise_for_status()
    return response.json()

def download_with_audio(job_id):
    """Κατεβάστε διαφάνειες με αρχεία ηχητικής φωνής."""
    response = requests.post(
        f'{BASE_URL}/slides/download-slides-pages-voices',
        headers=HEADERS,
        json={'jobId': job_id}
    )
    response.raise_for_status()
    return response.json()

Περιήγηση Θεμάτων

def search_themes(query=''):
    """Αναζητήστε διαθέσιμα θέματα διαφανειών."""
    params = {'query': query} if query else {}
    response = requests.get(
        f'{BASE_URL}/themes',
        headers=HEADERS,
        params=params
    )
    response.raise_for_status()
    return response.json()

themes = search_themes('corporate')
for theme in themes.get('themes', []):
    print(f"{theme['id']}: {theme['name']}")

Παράδειγμα Pipeline Παραγωγής

"""
Αυτοματοποιημένο pipeline εβδομαδιαίας αναφοράς.
Εκτέλεση μέσω cron: 0 9 * * MON python weekly_report.py
"""

import json
from datetime import datetime

def weekly_report_pipeline():
    print(f'Δημιουργία εβδομαδιαίας αναφοράς: {datetime.now().isoformat()}')

    # 1. Δημιουργία slides
    job = generate_slides(
        topic='''Εβδομαδιαία Ενημέρωση Μηχανικών — Εβδομάδα 23 Μαρτίου 2026:
        - Ανάπτυξη v2.4 στην παραγωγή (99.9% uptime)
        - 3 νέα API endpoints παραδόθηκαν
        - Απόδοση: p99 latency μειώθηκε κατά 40%
        - Ταχύτητα Sprint: 42 story points (στόχος: 40)
        - Επόμενη εβδομάδα: μετάβαση βάσης δεδομένων, νέο σύστημα auth''',
        theme_id='corporate-standard-id'
    )

    result = wait_for_job(job['jobId'])
    print(f'Τα slides είναι έτοιμα: {result["downloadUrl"]}')

    # 2. Προσθήκη αφήγησης
    add_narration(job['jobId'], mode='single', voice='Kore')
    print('Η αφήγηση προστέθηκε')

    # 3. Λήψη πακέτου
    package = download_with_audio(job['jobId'])
    print(f'Πλήρες πακέτο: {json.dumps(package, indent=2)}')

    return result['downloadUrl']

if __name__ == '__main__':
    url = weekly_report_pipeline()
    print(f'\nURL Αναφοράς: {url}')

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

from requests.exceptions import HTTPError, Timeout, ConnectionError

def safe_generate(topic, retries=3):
    """Δημιουργία slides με λογική επανάληψης."""
    for attempt in range(retries):
        try:
            job = generate_slides(topic)
            return wait_for_job(job['jobId'])
        except HTTPError as e:
            if e.response.status_code == 429:
                wait = 2 ** attempt * 5  # Εκθετική υποχώρηση
                print(f'Περιορισμός ρυθμού. Αναμονή {wait}s...')
                time.sleep(wait)
            elif e.response.status_code == 402:
                raise Exception('Ανεπαρκή πιστώσεις')
            else:
                raise
        except (Timeout, ConnectionError) as e:
            print(f'Σφάλμα δικτύου (προσπάθεια {attempt + 1}): {e}')
            time.sleep(5)
    raise Exception(f'Αποτυχία μετά από {retries} προσπάθειες')

Συχνές Ερωτήσεις

Ποια έκδοση Python απαιτείται;

Python 3.7+ για συμβατότητα με f-strings και

.

Μπορώ να χρησιμοποιήσω async Python (asyncio/aiohttp);

Ναι — αντικαταστήστε το

με για async κλήσεις HTTP. Το μοτίβο polling λειτουργεί με τον ίδιο τρόπο.

Πώς χειρίζομαι μεγάλες ομαδικές εργασίες;

Χρησιμοποιήστε asyncio για ταυτόχρονη εκτέλεση πολλαπλών δημιουργιών, σεβόμενοι το όριο ρυθμού (60 req/min).

---

Ξεκινήστε την αυτοματοποίηση — αποκτήστε το API key του 2Slides και δημιουργήστε παρουσιάσεις από Python.