

2slides API Tutorial – Der vollständige Leitfaden zur KI-gestützten Präsentationserstellung
Willkommen zum umfassenden Leitfaden für die 2slides API! Dieses Tutorial führt Sie durch alles, was Sie wissen müssen, um die KI-gestützte Präsentationserstellung in Ihre Anwendungen zu integrieren.
Überblick
Die 2slides API ermöglicht es Ihnen, professionelle Präsentationen programmatisch mithilfe von KI zu erstellen. Mit Unterstützung für verschiedene Präsentationstypen, darunter Zeitleisten, Roadmaps, Mindmaps und mehr, können Sie beeindruckende Folien aus einfachen Texteingaben erstellen.
Hauptmerkmale
- KI-gestützte Generierung: Automatische Erstellung professioneller Präsentationen aus Text
- Vielfältige Vorlagentypen: Unterstützung für Zeitleisten, Roadmaps, Mindmaps, Pitch Decks, Infografiken und mehr
- Mehrsprachige Unterstützung: Inhalte in mehreren Sprachen generieren
- Umfangreiche Vorlagenbibliothek: Zugriff auf Hunderte von professionell gestalteten Vorlagen
- Benutzerdefinierte Vorlagen: Eigene benutzerdefinierte Folienvorlagen hochladen und verwenden
- Vorlagen suchen: Vorlagen nach Namen, Keywords und Tags suchen
- Download-Optionen: Präsentationen im PowerPoint (.pptx)-Format erhalten
- Echtzeit-Statusverfolgung: Überwachen Sie den Generierungsfortschritt mit Job-Status-Endpunkten
Vorgestellte Präsentationstypen

Alle Präsentationsvorlagen finden Sie hier: 2slides Templates. Insbesondere gibt es einige vorgestellte Präsentationstypen, die sich sehr gut für bestimmte Zwecke und Szenarien eignen.
- Timeline-Folien – Perfekt für Projektzeitpläne und historische Ereignisse
- Roadmap-Folien – Ideal für Produkt-Roadmaps und Projektplanung
- Mindmap-Folien – Hervorragend für Konzept-Mapping und Wissensstrukturen
Erste Schritte
Basis-URL
Alle API-Anfragen sollten an folgende Adresse gerichtet werden:
https://2slides.com
Voraussetzungen
- Kontoerstellung: Erstellen Sie ein Konto unter 2slides.com
- API-Schlüssel: Generieren Sie einen API-Schlüssel auf Ihrer API-Verwaltungsseite
- Credits: Stellen Sie sicher, dass Sie über ausreichend Credits für die Folienerstellung verfügen (10 Credits pro Folienseite)
Schnellstart
- Holen Sie sich Ihren API-Schlüssel von der API-Verwaltungsseite
- Suchen Sie nach einem Thema mithilfe des Themen-Such-Endpunkts oder durchsuchen Sie die Vorlagen, um die Folienthema-ID zu erhalten
- Generieren Sie Folien mit Ihrem Inhalt und der ausgewählten Thema-ID. Dies unterstützt sowohl synchrone Aufrufe mit zurückgegebenen Ergebnis-Folien als auch asynchrone Aufrufe mit zurückgegebener Job-ID. Bei synchronen Aufrufen sind die nächsten Schritte 4 und 5 nicht erforderlich.
- Überprüfen Sie den Job-Status bis zum Abschluss; die Download-URL der generierten Folien wird bereitgestellt.
- Laden Sie Ihre Präsentation herunter mithilfe der bereitgestellten Download-URL.
Authentifizierung

Alle API-Endpunkte erfordern eine Authentifizierung mittels API-Schlüssel. Sie können Ihre API-Schlüssel über die API-Verwaltungsoberfläche verwalten.
API-Schlüssel-Format
API-Schlüssel folgen diesem Format:
sk-2slides-{64-character-hex-string}
Authentifizierungsmethoden
Autorisierungs-Header
Authorization: Bearer sk-2slides-your-api-key-here
API-Schlüssel-Verwaltung
- Maximale Anzahl an Schlüsseln: Jeder Benutzer kann bis zu 10 API-Schlüssel erstellen
- Schlüsselbenennung: Geben Sie Ihren Schlüsseln aussagekräftige Namen zur einfachen Identifizierung
- Sicherheit: Halten Sie Ihre API-Schlüssel sicher und teilen Sie sie niemals öffentlich
- Rotation: Rotieren Sie Ihre API-Schlüssel regelmäßig für erhöhte Sicherheit
⚠️ Wichtiger Sicherheitshinweis: Die 2slides-Plattform speichert Ihre API-Schlüssel aus Sicherheitsgründen NICHT im Klartext. Nach der Generierung müssen Sie Ihren API-Schlüssel sofort kopieren und sicher aufbewahren. Wenn Sie Ihren API-Schlüssel verlieren, müssen Sie einen neuen generieren, da der ursprüngliche nicht wiederhergestellt werden kann.
API-Endpunkte
1. Folien generieren (Fast PPT)
Generieren Sie Folien (Fast PPT) aus Texteingaben unter Verwendung eines bestimmten Themas.
Endpunkt:
POST /api/v1/slides/generateHeader:
Authorization: Bearer sk-2slides-your-api-key-here Content-Type: application/json
Anfrage-Body:
{ "userInput": "Ihr Präsentationsinhalt hier...", "themeId": "theme-uuid-here", "responseLanguage": "Auto" }
Parameter:
- (erforderlich): Der Inhalt, für den Sie Folien generieren möchten
userInput - (erforderlich): ID des Themas, das für die Folienerstellung verwendet werden soll. Dies kann sein:
themeId- Öffentliche Themen aus der Vorlagengalerie
- Ihre eigenen hochgeladenen benutzerdefinierten Themen (über Ihr Konto zugänglich)
- (optional): Sprache für die generierten Folien. Verwenden Sie „Auto“ für die automatische Erkennung
responseLanguage - (optional): Synchroner (sync) oder asynchroner (async) Aufruf, „sync“ ist der Standard
mode
Verfügbare Sprachen:
- – Automatische Spracherkennung aus der Eingabe (Standard)
Auto - – Englisch
English - – 简体中文
Simplified Chinese - – 繁體中文
Traditional Chinese - – Español
Spanish - – العربية
Arabic - – Português
Portuguese - – Bahasa Indonesia
Indonesian - – 日本語
Japanese - – Русский
Russian - – हिंदी
Hindi - – Français
French - – Deutsch
German - – Tiếng Việt
Vietnamese - – Türkçe
Turkish - – Polski
Polish - – Italiano
Italian - – 한국어
Korean
Antwort im asynchronen Modus:
{ "success": true, "data": { "jobId": "job-uuid-here", "status": "processing", "message": "Slides generation started. Use the jobId to check status.", "credits": { "current": 150, "required": 30 } } }
Antwort im synchronen Modus:
{ "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. Job-Status überprüfen (Fast PPT)
Überprüfen Sie den Status eines Folienerstellungsauftrags (Fast PPT) und erhalten Sie die Ergebnisse nach Abschluss.
Endpunkt:
GET /api/v1/jobs/{jobId}Header:
Authorization: Bearer sk-2slides-your-api-key-here
Antwortbeispiele:
In Bearbeitung:
{ "success": true, "data": { "jobId": "job-uuid-here", "status": "processing", "message": "Slides generation in progress", "createdAt": 1703123456789, "updatedAt": 1703123460000 } }
Erfolgreich:
{ "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 } }
Fehlgeschlagen:
{ "success": true, "data": { "jobId": "job-uuid-here", "status": "failed", "message": "Slides generation failed", "errorMessage": "Insufficient credits for generation", "createdAt": 1703123456789, "updatedAt": 1703123460000 } }
3. Folien wie diese erstellen (Nano Banana Pro)
Generieren Sie Folien (Nano Banana Pro) aus einem Referenzbild. Dieser Endpunkt verwendet den synchronen Modus und generiert automatisch ein PDF, sobald alle Folien fertiggestellt sind.
Endpunkt:
POST /api/v1/slides/create-like-thisHeader:
Authorization: Bearer sk-2slides-your-api-key-here Content-Type: application/json
Anfrage-Body:
{ "userInput": "Ihr Präsentationsinhalt hier...", "referenceImageUrl": "https://example.com/reference-image.jpg", "responseLanguage": "Auto", "aspectRatio": "16:9", "resolution": "2K", "page": 1 }
Parameter:
- (erforderlich): Der Inhalt, für den Sie Folien generieren möchten
userInput - (erforderlich): URL des Referenzbildes, dessen Designstil übernommen werden soll. Unterstützt:
referenceImageUrl- HTTP/HTTPS-URLs
- Base64-Daten-URLs (data:image/...)
- (optional): Sprache für die generierten Folien. Verwenden Sie „Auto“ für die automatische Erkennung (Standard: „Auto“)
responseLanguage - (optional): Seitenverhältnis für die Folien. Format: „Breite:Höhe“ (Standard: „16:9“)
aspectRatio - (optional): Auflösung für Folienbilder. Optionen: „1K“, „2K“, „4K“ (Standard: „2K“)
resolution - (optional): Anzahl der zu generierenden Folien. Verwenden Sie 0 für die automatische Erkennung. Geben Sie eine Zahl (>=1, max: 100) an, um diese Anzahl an Folien zu erzwingen. Standard: 1.
page - (optional): Detaillierungsgrad des Inhalts für Folien. Optionen: „concise“ (prägnant, schlüsselwortorientiert) oder „standard“ (umfassend, detailliert). Standard: „concise“.
contentDetail
Antwort:
{ "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 } }
Statuswerte:
- : Alle Folien erfolgreich generiert, PDF ist verfügbar
success - : Einige Folien konnten nicht generiert werden
partial - : Alle Folien konnten nicht generiert werden
failed
Hinweis: Dieser Endpunkt läuft im synchronen Modus und wartet, bis alle Folien generiert wurden, bevor er eine Antwort zurückgibt.
4. Themen suchen (Fast PPT)
Suchen Sie nach verfügbaren Folienthemen (Fast PPT) nach Stichwort. Dies umfasst sowohl öffentliche Themen als auch Ihre eigenen hochgeladenen benutzerdefinierten Themen.
Endpunkt:
GET /api/v1/themes/searchHeader:
Authorization: Bearer sk-2slides-your-api-key-here
Abfrageparameter:
- (erforderlich): Schlüsselwort zur Suche in Themennamen, Beschreibungen und Tags
query - (optional): Maximale Anzahl der Ergebnisse (1-100, Standard 20)
limit
Beispielanfrage:
GET /api/v1/themes/search?query=timeline&limit=10
Antwort:
{ "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" } ] } }
Ratenbegrenzung
Die API implementiert Ratenbegrenzungen, um eine faire Nutzung und Systemstabilität zu gewährleisten. Verschiedene Endpunkte haben unterschiedliche Ratenbegrenzungen:
| Endpunkt | Zeitfenster | Max. Anfragen | Beschreibung |
|---|---|---|---|
/api/v1/slides/generate | 1 Minute | 6 Anfragen | Kern-Generierungs-Endpunkt |
/api/v1/slides/create-like-this | 1 Minute | 6 Anfragen | Folien aus Referenzbild erstellen |
/api/v1/jobs | 1 Minute | 10 Anfragen | Job-Statusprüfung |
/api/v1/themes/search | 1 Minute | 30 Anfragen | Themensuche |
Ratenbegrenzungs-Header
Wenn Ratenbegrenzungen überschritten werden, gibt die API eine
429 Too Many RequestsHTTP/1.1 429 Too Many Requests X-RateLimit-Limit: 6 X-RateLimit-Remaining: 0 X-RateLimit-Reset: 1703123600 Retry-After: 45
Umgang mit Ratenbegrenzungen
Sie müssen die Ratenbegrenzung für API-Aufrufe sorgfältig handhaben; hier ist ein Beispiel in 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 verwendet ein kreditbasiertes System für die Folienerstellung. Jede Folienseite kostet 10 Credits.
Credit-Regeln
- Neue Benutzer: Erhalten 880 kostenlose Credits bei der Registrierung
- Kosten: 10 Credits pro Folienseite (Fast PPT), 100 Credits pro 1K/2K Nano Banana Pro Folienseite, 200 Credits pro 4K Nano Banana Pro Folienseite
- Minimum: Benutzer benötigen mindestens 10 Credits, um die Generierung zu starten
- Abzug: Credits werden nur nach erfolgreicher Generierung abgezogen
- Rückerstattungen: Credits werden zurückerstattet, wenn die Generierung fehlschlägt
Credits überprüfen
Sie können Ihr Guthaben über das Konten-Dashboard überprüfen oder die Kreditinformationen in den API-Antworten einsehen.
Credits kaufen
Zusätzliche Credits können über die Preisseite mit verschiedenen Zahlungsmethoden erworben werden.
Beispiele
Vollständiges Workflow-Beispiel
Hier ist ein vollständiges Beispiel für die Generierung von Folien mit der 2slides API in Javascript und 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 Beispiel
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 Beispiele
Themen suchen:
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"
Folien generieren:
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" }'
Job-Status überprüfen:
curl -X GET "https://2slides.com/api/v1/jobs/job-uuid-here" \ -H "Authorization: Bearer sk-2slides-your-api-key-here"
Fehlerbehandlung
Die API verwendet Standard-HTTP-Statuscodes und gibt detaillierte Fehlerinformationen im JSON-Format zurück.
Häufige Fehlermeldungen
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" }
Best Practices für die Fehlerbehandlung
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-Schlüssel-Sicherheit
- API-Schlüssel niemals preisgeben in clientseitigem Code oder öffentlichen Repositories
- Umgebungsvariablen verwenden, um API-Schlüssel sicher zu speichern
- Schlüssel regelmäßig rotieren für erhöhte Sicherheit
- Schlüsselnutzung überwachen über das API-Verwaltungs-Dashboard
- Schlüssel sicher speichern: Denken Sie daran, dass 2slides Ihre API-Schlüssel nicht speichert, daher müssen Sie sie sicher aufbewahren
- Ihre Schlüssel sichern: Speichern Sie API-Schlüssel in einem sicheren Passwortmanager oder verschlüsselten Speicher
2. Effiziente API-Nutzung
- Suchergebnisse für Themen cachen, um wiederholte Anfragen zu vermeiden
- Angemessene Abfrageintervalle implementieren für Job-Status-Prüfungen (2-5 Sekunden)
- Ratenbegrenzungen elegant handhaben mit exponentiellem Backoff
- Batch-Operationen wenn möglich, um API-Aufrufe zu reduzieren
3. Fehlerbehandlung
- Antwort-Statuscodes immer überprüfen
- Wiederholungslogik implementieren für vorübergehende Fehler
- Fehler angemessen protokollieren zur Fehlerbehebung
- Benutzerfreundliche Fehlermeldungen bereitstellen
4. Leistungsoptimierung
- Angemessene Abfrageintervalle verwenden, um unnötige Anfragen zu vermeiden
- Anfrage-Timeouts implementieren, um hängende Anfragen zu verhindern
- Häufig verwendete Daten cachen wie Themeninformationen
- Ihre Credit-Nutzung überwachen, um unerwartete Kosten zu vermeiden
5. Inhaltsrichtlinien
- Klare, strukturierte Eingaben bereitstellen für eine bessere Foliengenerierung
- Geeignete Themen verwenden für Ihren Inhaltstyp
- Sprache angeben, wenn für internationale Inhalte erforderlich
- Inhalte prägnant halten für ein optimales Folienlayout
Support & Ressourcen
Dokumentation & Ressourcen
- API-Dokumentation – Interaktive API-Dokumentation und Playground
- Vorlagengalerie – Verfügbare Folienvorlagen durchsuchen
- Preisinformationen – Credit-Pakete und Preise
- Blog – Neueste Updates und Tipps
Hilfe erhalten
- API Playground: Testen Sie Ihre API-Aufrufe direkt im Browser unter 2slides.com/api
- Konten-Dashboard: Verwalten Sie Ihre Credit-Nutzung unter 2slides.com/account
- Support: Kontaktieren Sie den Support über die Hauptwebsite
Community & Updates
- Feature-Updates: Bleiben Sie über neue Funktionen und Verbesserungen auf dem Laufenden
- Vorlagenbibliothek: Regelmäßige Ergänzungen neuer professioneller Vorlagen
- API-Verbesserungen: Kontinuierliche Verbesserungen der API-Leistung und -Funktionen
Fazit
Die 2slides API bietet eine leistungsstarke und flexible Möglichkeit, professionelle Präsentationen programmatisch zu erstellen. Mit ihrem umfassenden Funktionsumfang, der robusten Fehlerbehandlung und der umfangreichen Vorlagenbibliothek können Sie die KI-gestützte Folienerstellung in jede Anwendung oder jeden Workflow integrieren.
Beginnen Sie noch heute mit der Erstellung beeindruckender Präsentationen mit der 2slides API! Besuchen Sie 2slides.com/api, um Ihren API-Schlüssel zu erhalten und loszulegen.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free