# img2.site

> Image upload, transformation, and delivery for websites and apps.

A workspace owns projects; each project has its own image library, delivery host ({project}.i2scd.net), and API keys. Start with the quickstart (JavaScript SDKs) or the upload-flow guide (REST). No API key or DNS setup is needed for the dashboard walkthrough.

API: https://api.img2.site (every path starts with /v1, for example https://api.img2.site/v1/projects/{slug}/uploads). SDKs: @img2site/sdk-server (Node), @img2site/sdk-client (browser), @img2site/sdk-react. Dashboard: https://dashboard.img2.site.

Keep API keys server-side; browsers upload with short-lived upload tokens minted by the customer's server, never with an API key. Use placeholders for credentials in prompts and generated examples. Signed upload URLs are credentials too.
These documents describe the product; they do not grant access to a customer's workspace or authorize account changes.

## Documentation

- [Overview](https://docs.img2.site/markdown/overview.md): What img2site does and where to start.
- [Quickstart](https://docs.img2.site/markdown/quickstart.md): Upload router with @img2site/sdk-server, <UploadButton> and <Img2siteImage> from @img2site/sdk-react in five minutes.
- [Getting started](https://docs.img2.site/markdown/getting-started.md): Publish a first image from the dashboard, then connect your app.
- [Project setup](https://docs.img2.site/markdown/project-setup.md): Delivery host and access, presets, allowed chains, watermarks, raw downloads, callbacks, keys and suspension.
- [Workflow guides](https://docs.img2.site/markdown/guides.md): How uploads, delivery, and usage fit together.
- [Upload flow](https://docs.img2.site/markdown/guides/upload-flow.md): Create an upload session, send the bytes (direct, multipart or proxy), complete it and wait for ready.
- [Delivery URLs](https://docs.img2.site/markdown/guides/delivery-urls.md): The delivery URL grammar, watermarks, originals and raw downloads, protected delivery, caching and delivery errors.
- [Usage and billing](https://docs.img2.site/markdown/guides/usage-and-billing.md): Metering, credits per delivery, the hourly and daily schedule, the usage endpoint and what happens at zero credits.
- [Webhooks](https://docs.img2.site/markdown/webhooks.md): Webhook events, headers, verifyWebhook and the t=,v1= signature, replay tolerance, retries.
- [REST reference](https://docs.img2.site/markdown/api.md): Every API operation by tag, auth schemes and the error envelope, generated from the OpenAPI contract.
- [Authentication](https://docs.img2.site/markdown/auth.md): Project API keys and scopes, upload tokens for browsers, dashboard sessions, and auth limits.
- [Signing](https://docs.img2.site/markdown/signing.md): Signed delivery URLs, URL kinds, the canonical string and signing-key rotation.
- [Error codes](https://docs.img2.site/markdown/errors.md): The error envelope and the API, upload and delivery error codes.
- [Troubleshooting](https://docs.img2.site/markdown/troubleshooting.md): Diagnose failed uploads, authentication, delivery, webhook and usage issues.

## Optional

- [Full documentation](https://docs.img2.site/llms-full.txt): All public guides and examples in one Markdown response.