# AetherLab Agent Kit

> Document conversion APIs for agent workflows. Convert HTML slides, Markdown, PDF, and spreadsheets into production-ready files through browser tests or paid API calls.

Base URL: https://agent.aetherlab.me
Product URL: https://agent.aetherlab.me/kit/
API docs: https://agent.aetherlab.me/kit/docs/
Support: contact@aetherlab.me

## API

Authentication uses the `sk` header with a secret key generated after sign-in.

All convert endpoints accept JSON with public source URLs:

```json
{"files":["https://example.com/input.pdf"]}
```

All convert endpoints return:

```json
{
  "jobId": "uuid",
  "feature": "pdf_md",
  "urls": ["https://agent.aetherlab.me/converted/YYYY-MM-DD/file.md"]
}
```

For PDF to Markdown, `urls` can contain the Markdown file plus extracted image files.

## Endpoints

- `POST https://agent.aetherlab.me/v1/convert/pdf_md` - Convert one public text-based PDF URL to Markdown and extracted images.
- `POST https://agent.aetherlab.me/v1/convert/html_pdf` - Convert 1-30 public HTML slide URLs to PDF.
- `POST https://agent.aetherlab.me/v1/convert/html_pptx` - Convert 1-30 public HTML slide URLs to PPTX.
- `POST https://agent.aetherlab.me/v1/convert/md_docx` - Convert one public Markdown, TXT, or MD URL to DOCX.
- `POST https://agent.aetherlab.me/v1/convert/spreadsheet_json` - Convert one public XLSX, XLS, CSV, or TSV URL to JSON.

## Important Pages

- Overview: https://agent.aetherlab.me/kit/
- PDF to Markdown API: https://agent.aetherlab.me/kit/docs/pdf-to-markdown
- HTML to PDF API: https://agent.aetherlab.me/kit/docs/html-to-pdf
- HTML to PPTX API: https://agent.aetherlab.me/kit/docs/html-to-pptx
- Markdown to DOCX API: https://agent.aetherlab.me/kit/docs/markdown-to-docx
- Spreadsheet to JSON API: https://agent.aetherlab.me/kit/docs/spreadsheet-to-json

## Positioning

AetherLab Agent Kit is built for developers and AI agents that need deterministic document conversion results. Each request consumes one credit. Paid plans unlock API access and higher concurrency.