# vid2md

vid2md turns video URLs or uploaded video files into timestamped Markdown reports.

API summary:
- Email login code from /v1/auth/start and /v1/auth/verify
- Bearer API keys from /v1/api-keys after login; list, rename, and revoke keys through the same resource
- Modes: concise, regular, detailed, ultra-detailed
- Credits: concise 1 credit per started minute, regular 2x, detailed 4x, ultra-detailed 8x
- Polar credit packages: starter, growth, scale
- Archive subscription keeps Markdown results, vid2md does not archive source videos
- Inputs: public HTTPS video_url or POST /v1/uploads tokenized R2 handoff
- Public demo: POST /v1/demo before login, claim result after email login
- Polling: create /v1/jobs, poll /v1/jobs/{job_id}, list history with /v1/jobs, download /v1/jobs/{job_id}/result
- Result CRUD: GET, PUT, and DELETE /v1/jobs/{job_id}/result manage saved Markdown
- Policy: keyframes pass moderation before Markdown generation
- Agent entry: /docs/agents

Docs:
https://vid2md.com/docs/quickstart
https://vid2md.com/docs/api
https://vid2md.com/docs/output-format
https://vid2md.com/docs/agents
https://vid2md.com/docs/privacy

Markdown copies:
https://vid2md.com/api/markdown/quickstart
https://vid2md.com/api/markdown/api
https://vid2md.com/api/markdown/output-format
https://vid2md.com/api/markdown/agents
https://vid2md.com/api/markdown/privacy

Preferred agent entry:
https://vid2md.com/docs/agents