Dostępne w planie Pro

Generuj prezentacje przez API

Proste API REST: wyślij tekst i otrzymaj uporządkowany, edytowalny plik .pptx. Dodaj generowanie slajdów bezpośrednio do swoich produktów i procesów.

Utwórz klucz API

W każdym płatnym planie, od 35 zł/mies. lub 299 zł/rok. Twórz klucze i zarządzaj nimi w panelu.

POST /v1/decks
curl -X POST https://prezto.io/v1/decks \
  -H "Authorization: Bearer $PREZTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7b1f584f-f42b-4e92-83fb-707877f539b1" \
  -d '{
  "source": "Lekcja: fotosynteza…",
  "theme": "serein",
  "title": "Fotosynteza",
  "output_locale": "pl"
}'

# → 202 Accepted
{
  "id": "deck_8fk2",
  "status": "processing",
  "download_url": null
}

Uwierzytelnianie

Każdy klucz API zaczyna się od przk_ i jest wysyłany w nagłówku Authorization w formacie Bearer. Klucze można tworzyć i unieważniać w panelu. Nie są ponownie wyświetlane po utworzeniu: przechowuj je bezpiecznie.

Nowe plany: dodaj nagłówek Idempotency-Key zawierający stały UUID dla każdego żądania. Użyj go ponownie przy ponawianiu tego samego żądania: zwracany jest ten sam identyfikator bez ponownego odliczenia. Inna treść z tym samym kluczem zwraca 409; usunięta prezentacja zwraca 410.

nagłówek
"Authorization: Bearer przk_a1b2c3d4e5f6…"
Otwórz panel

Zastosowania

Co nasi partnerzy tworzą z użyciem API.

LMS

Platformy edukacyjne

Udostępnij nauczycielom przycisk eksportu slajdów: każdy moduł kursu staje się prezentacją.

EDTECH

Produkty edtech

Rozszerz ofertę o generowanie prezentacji z treści już dostępnych w Twojej aplikacji.

AUTOMATION

Automatyzacja kursów

Połącz Prezto ze skryptami i narzędziami no-code, aby tworzyć materiały szkoleniowe na dużą skalę.

4 endpointy obsługujące cały cykl generowania

Utwórz prezentację, śledź jej status, pobierz plik i wyświetl dostępne motywy.

POST/v1/decksUtwórz prezentację z tekstu
GET/v1/decks/{id}Śledź status i pobierz adres URL do pobrania
GET/v1/decks/{id}/downloadPobierz wygenerowany plik .pptx
GET/v1/themesWyświetl dostępne motywy

Utwórz prezentację

source jest wymagane (tekst do przetworzenia, maksymalnie 100 000 znaków). theme i title są opcjonalne.

POST /v1/decks
curl -X POST https://prezto.io/v1/decks \
  -H "Authorization: Bearer $PREZTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7b1f584f-f42b-4e92-83fb-707877f539b1" \
  -d '{
  "source": "Lekcja: fotosynteza…",
  "theme": "serein",
  "title": "Fotosynteza",
  "output_locale": "pl",
  "mode": "preserver",
  "slide_count": 12,
  "audience": "uczniowie ósmej klasy"
}'

# → 202 Accepted
{
  "id": "deck_8fk2",
  "status": "processing",
  "download_url": null
}

Sterowanie generowaniem

Parametry opcjonalne dostosowują poziom szczegółowości generowania.

modegenerer | condenser | preserver

Wierność tekstowi źródłowemu. condenser (domyślnie): wierne, uporządkowane podsumowanie. preserver: tekst jest dzielony na slajdy bez przepisywania i utraty treści. generer: AI rozwija i wzbogaca treść bez wymyślania danych liczbowych.

densityminimal | standard | detaille

Gęstość tekstu na slajdzie. minimal: od 3 do 5 krótkich punktów, reszta w notatkach prelegenta. standard (domyślnie): informacyjne punkty od 8 do 20 słów. detaille: rozbudowane punkty i szczegółowe notatki prelegenta.

slide_countliczba całkowita, od 3 do 30

Docelowa liczba slajdów. Jeśli zostanie pominięta, liczba slajdów jest obliczana automatycznie na podstawie długości tekstu.

audiencetekst, maks. 300 znaków

Odbiorcy (np. uczniowie ósmej klasy lub zarząd): dostosowywane są słownictwo, przykłady i poziom szczegółowości.

tonetekst, maks. 200 znaków

Ton prezentacji (np. dydaktyczny, formalny lub entuzjastyczny).

instructionstekst, maks. 1000 znaków

Dowolne instrukcje stosowane podczas generowania (np. skup się na części 2 lub zakończ quizem).

image_countliczba całkowita, od 0 do 10, lub auto

Liczba ilustracji generowanych przez AI na odpowiednich slajdach (tytuł, sekcje i lżejsza treść), w stylu prezentacji i osadzonych w pliku .pptx. 0 (domyślnie): brak. auto: silnik rozmieszcza do 10 ilustracji. Dostępne w planie Pro (wymaganym już do API).

imageswartość logiczna (przestarzałe)

Starszy parametr: true odpowiada image_count = auto (do 10 ilustracji); false lub brak oznacza 0. Zachowany dla zgodności; preferuj image_count. Podany image_count ma pierwszeństwo.

output_localefr | en | es | pl

Język wynikowej prezentacji.

Śledź status

Odpytuj ten endpoint, aż status zmieni się na done.

GET /v1/decks/{id}
curl https://prezto.io/v1/decks/deck_8fk2 \
  -H "Authorization: Bearer $PREZTO_API_KEY"

# → 200 OK
{
  "status": "done",
  "download_url": "https://prezto.io/v1/decks/deck_8fk2/download",
  "slides_count": 12,
  "expires_at": null
}

Pobierz plik

Zwraca bezpośrednio plik .pptx, bez ograniczenia czasu przechowywania. Plik jest uniwersalnie zgodny: ilustracje mają postać obrazów obok natywnych elementów PowerPoint, bez osadzonych formatów wektorowych; otwiera się identycznie w PowerPoint, Keynote i Google Slides.

GET /v1/decks/{id}/download
curl https://prezto.io/v1/decks/deck_8fk2/download \
  -H "Authorization: Bearer $PREZTO_API_KEY" \
  -o presentation.pptx

# → 200 OK (.pptx)

Wyświetl motywy

Przydatne do zbudowania selektora motywów we własnym interfejsie.

GET /v1/themes
curl https://prezto.io/v1/themes

# → 200 OK
{
  "themes": [
    {
      "id": "serein",
      "name": "Serein"
    },
    {
      "id": "minimal",
      "name": "Minimal"
    },
    {
      "id": "contraste",
      "name": "Ardoise"
    }
  ]
}

Statusy prezentacji

StatusZnaczenie
processingPrezentacja jest generowana. download_url ma wartość null.
donePrezentacja jest gotowa. download_url wskazuje plik .pptx.
failedGenerowanie nie powiodło się. Spróbuj ponownie z innym tekstem źródłowym.

Limity

Dostępne w planie Pro

Twórz klucze API bezpośrednio w panelu.

Otwórz panel

Zobacz ceny korzystania z interfejsu internetowego.