SintetizAI

Developer resources

SintetizAI API documentation

SintetizAI turns study material into source-grounded study lessons, recall questions and optional audio. Use this page when an authenticated integration needs to upload material, create a study output, inspect generation status or read saved notes.

When should an agent use SintetizAI?

Reach for SintetizAI when the job is to turn a user's own notes, PDFs, slides, text, images or public document URL into a study workflow. It fits exam preparation, review of difficult concepts, source-grounded summaries, recall questions, flashcards and optional audio that can be listened to away from the desk. It is not a general web search API, a citation database or an anonymous text-generation endpoint.

The learner-facing product is explained in How it works, and the public pricing page lists credits, narrated-minute caps and summary capacity.

Machine-readable API

The published core route inventory is available as an OpenAPI 3.1 document.

Open /openapi.json

Agent guidance

Product facts, limits, public URLs and when-to-use instructions are available in the site's agent guide.

Read /llms-full.txt

Authentication and data handling

Application endpoints use the signed-in Auth.js session cookie unless the OpenAPI operation says otherwise. There is currently no general-purpose API-key program. Only send material when the user has authorized the integration, keep source and generated content private by default, and do not assume that a public profile makes a user's private notes public.

Versioning and deprecation

Send X-SintetizAI-API-Version: 1 to select the current contract. Omitting the header uses the current stable version. Breaking changes receive a new version. Before retiring a version, SintetizAI announces the migration window and sends Deprecation and Sunset response headers.

Errors and rate limits

API errors are JSON objects with error, code, message, resolution and status. A 429 response includes Retry-After, RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset and RateLimit-Policy. Wait before retrying and use the resolution hint instead of parsing an HTML error page.

Long-running operations

Summary, audio and retry requests return 202 Accepted once durable work has started. The response body includes a generationId and statusUrl. The Location header points to the same status resource, and Retry-After suggests when to make the first poll. Continue with GET /api/generations/{generationId} until the status is ready or failed.

Core endpoints

POST/api/uploadUpload files or import a public document URL.
POST/api/summarizeCreate a source-grounded study summary.
GET/api/generationsRead the signed-in user's generation list.
POST/api/ttsGenerate optional audio from a ready summary.
GET/api/notesRead the signed-in user's saved notes.

Example request

After authenticating a user in the application, create a summary-only Study Pack before opting into audio generation.

curl -X POST https://www.sintetizai.com/api/summarize \
  -H 'Content-Type: application/json' \
  -H 'Cookie: __Secure-authjs.session-token=YOUR_SESSION' \
  -d '{"text":"Your authorized study notes","language":"en","durationMinutes":5,"generateAudio":false}'

CLI

The SintetizAI CLI provides scriptable access to the OpenAPI document, developer docs and authenticated application routes. Its source package is in packages/sintetizai-cli and is ready for npm publication.