# Dafty Docs

## Docs

- [Get account](https://docs.dafty.ai/api-reference/account/get-account.md)
- [Edit a prior generation](https://docs.dafty.ai/api-reference/images/edit-a-prior-generation.md): `image` is the job id of a completed image you own; the edit replays that job’s edit chain.
- [Generate a new image](https://docs.dafty.ai/api-reference/images/generate-a-new-image.md)
- [Get an image job](https://docs.dafty.ai/api-reference/images/get-an-image-job.md)
- [Reframe a prior generation to a new aspect ratio](https://docs.dafty.ai/api-reference/images/reframe-a-prior-generation-to-a-new-aspect-ratio.md): `image` is a prior job id. Returns a new job (reported as `image.edit`).
- [Upscale a prior generation](https://docs.dafty.ai/api-reference/images/upscale-a-prior-generation.md): `image` is a prior job id. Returns a new job (reported as `image.edit`).
- [Cancel an in-flight job](https://docs.dafty.ai/api-reference/jobs/cancel-an-in-flight-job.md)
- [List your jobs](https://docs.dafty.ai/api-reference/jobs/list-your-jobs.md): Cursor-paginated. A recovery path when a client loses job ids. Lists image generation jobs only; style-extraction jobs are polled individually via `GET /styles/extractions/{id}`.
- [Poll any job](https://docs.dafty.ai/api-reference/jobs/poll-any-job.md): Add `?wait=true` to long-poll up to ~55s. On timeout the job is returned in its current (possibly non-terminal) state; re-issue to keep waiting.
- [Extract a brand/style from a URL](https://docs.dafty.ai/api-reference/styles/extract-a-brandstyle-from-a-url.md)
- [Get a style](https://docs.dafty.ai/api-reference/styles/get-a-style.md)
- [Get an extraction job](https://docs.dafty.ai/api-reference/styles/get-an-extraction-job.md)
- [List styles](https://docs.dafty.ai/api-reference/styles/list-styles.md): Cursor-paginated.
- [Semantic search a style's linked-folder assets](https://docs.dafty.ai/api-reference/styles/semantic-search-a-styles-linked-folder-assets.md)
- [Finalize an upload](https://docs.dafty.ai/api-reference/uploads/finalize-an-upload.md): Call after PUTting your bytes to the presigned `uploadUrl`. Returns the stored upload; pass its `id`/`url` as a `references` entry on a generation. See the [Uploads guide](/uploads) for a full walkthrough.
- [Presign a direct-to-storage upload](https://docs.dafty.ai/api-reference/uploads/presign-a-direct-to-storage-upload.md): Returns a presigned `uploadUrl`. PUT your image bytes to it, then call `POST /uploads/{uploadId}/complete` to finalize. See the [Uploads guide](/uploads) for a full walkthrough.
- [Animate a single image into a video](https://docs.dafty.ai/api-reference/videos/animate-a-single-image-into-a-video.md): Bring one image to life: fast, affordable, audio included. The output video is rendered at the reference image's aspect ratio. Returns a `video.generate` job; poll `GET /videos/{id}` (optionally `?wait=true`).
- [Generate a video that transitions between two frames](https://docs.dafty.ai/api-reference/videos/generate-a-video-that-transitions-between-two-frames.md): A planned start→end motion. Both `startImage` and `endImage` are required. Slower and pricier than image-to-video; use it when you have both ends of the shot.
- [Get a video job](https://docs.dafty.ai/api-reference/videos/get-a-video-job.md)
- [Authentication](https://docs.dafty.ai/authentication.md): Authenticate every request with an API key.
- [Errors](https://docs.dafty.ai/errors.md): Error shape, codes, and how to handle them.
- [Idempotency](https://docs.dafty.ai/idempotency.md): Make create requests safe to retry without double-charging.
- [Dafty API](https://docs.dafty.ai/index.md): Generate on-brand image and video from a simple, opinionated REST API.
- [Polling & wait](https://docs.dafty.ai/polling-and-wait.md): How to wait for a job to finish, efficiently.
- [Quickstart](https://docs.dafty.ai/quickstart.md): Generate your first image in three calls: authenticate, generate, poll.
- [Rate limits](https://docs.dafty.ai/rate-limits.md): Per-key limits and how to back off.
- [Uploads](https://docs.dafty.ai/uploads.md): Bring your own reference images with a direct-to-storage upload.
- [Generating video](https://docs.dafty.ai/videos.md): Animate a single image, or transition between two frames - when to use which, and how to poll for the clip.

## OpenAPI Specs

- [openapi](https://docs.dafty.ai/openapi.json)