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

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

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

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

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

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

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

pip install requests python-dotenv

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

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 και requests.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

About 2Slides

Summarize with AI

Products

Features

Gallery

Templates

Integrations

Resources

Comparison