# SegmentationAPI

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.segmentationapi.com/_mcp/server

## Docs

- [Documentation](https://docs.segmentationapi.com/guides/introduction.md): Complete SegmentationAPI reference for uploading media, creating jobs, and retrieving SAM 3 results.
- [Authentication](https://docs.segmentationapi.com/guides/authentication.md): API key authentication, required headers, and rate limits for SegmentationAPI endpoints.
- [Upload](https://docs.segmentationapi.com/guides/upload.md): Request presigned upload URLs, upload files to S3, and manage task IDs for segmentation jobs.
- [Jobs](https://docs.segmentationapi.com/guides/jobs.md): Create async image and video segmentation jobs, list job history, and retrieve per-item results.
- [Results](https://docs.segmentationapi.com/guides/results.md): Request a results archive, poll until it is ready, and read output_manifest.json to retrieve image and video segmentation masks.
- [SDKs](https://docs.segmentationapi.com/guides/sdks.md): Install the SegmentationAPI TypeScript SDK and run upload, job, and download.
- [CLI](https://docs.segmentationapi.com/guides/cli.md): Run SegmentationAPI from the terminal with the segment CLI.
- [Free API trial](https://docs.segmentationapi.com/guides/free-api-trial.md): Use 100 free image tokens through the production API without a credit card.
- [SAM 3 alternatives](https://docs.segmentationapi.com/comparisons/sam-3-alternatives.md): Benchmark comparisons, capability matrices, and deployment trade-offs for SAM 3 and its leading alternatives.

## API Docs

- API Reference > Uploads [Create a presigned upload URL for an input file](https://docs.segmentationapi.com/api-reference/uploads/create-upload-presign.md)
- API Reference > Jobs [List jobs for the authenticated account](https://docs.segmentationapi.com/api-reference/jobs/list-jobs.md)
- API Reference > Jobs [Create an asynchronous segmentation job (image or video)](https://docs.segmentationapi.com/api-reference/jobs/create-job.md)
- API Reference > Jobs [Get async segmentation job status](https://docs.segmentationapi.com/api-reference/jobs/retrieve-job.md)
- API Reference > Jobs [Retrieve a completed segmentation job result](https://docs.segmentationapi.com/api-reference/jobs/retrieve-job-result.md)
- API Reference > Jobs [Get async job archive download status](https://docs.segmentationapi.com/api-reference/jobs/retrieve-job-download.md)
- API Reference > Jobs [Create or reuse an async job archive download](https://docs.segmentationapi.com/api-reference/jobs/create-job-download.md)
- API Reference > Account [Retrieve the authenticated account](https://docs.segmentationapi.com/api-reference/account/get-account.md)
- API Reference > Account [Retrieve account usage and billing status](https://docs.segmentationapi.com/api-reference/account/get-account-overview.md)
- API Reference > API Keys [List API keys](https://docs.segmentationapi.com/api-reference/api-keys/list-api-keys.md)
- API Reference > API Keys [Create an API key](https://docs.segmentationapi.com/api-reference/api-keys/create-api-key.md)
- API Reference > API Keys [Revoke an API key](https://docs.segmentationapi.com/api-reference/api-keys/revoke-api-key.md)
- API Reference > Billing [Create a billing checkout session](https://docs.segmentationapi.com/api-reference/billing/create-checkout.md)
- API Reference > Billing [Create a billing portal session](https://docs.segmentationapi.com/api-reference/billing/create-billing-portal.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.segmentationapi.com/openapi.json)
- [OpenAPI YAML](https://docs.segmentationapi.com/openapi.yaml)