# diffusr docs

> diffusr makes ad videos, images and music. This API and the MCP server let an AI agent or a program make them too. Every call that makes something costs credits (1 credit = $0.01): send `dry_run: true` first to get the price free, then start with an Idempotency-Key. Use a test key (`dfsr_test_...`) while you build: real prices, fake results, nothing charged.

Machine-readable spec (OpenAPI 3.1): https://app.diffusr.ai/api/v2/openapi.json
Everything in one file: https://diffusr.ai/docs/llms-full.txt
MCP server: https://app.diffusr.ai/api/mcp (OAuth by URL)

## Start

- [Overview](https://diffusr.ai/docs/index.md): diffusr makes ad videos, images and music. Call it from code, or let your AI agent do it. This page is the map.
- [Quickstart](https://diffusr.ai/docs/quickstart.md): Check the price for free, make the video, and get told when it is ready. Use a test key while you build: results are fake and nothing is charged.
- [Test keys](https://diffusr.ai/docs/test-keys.md): A test key does everything a live key does except spend. Prices are real, results are placeholders, nothing is charged.
- [Prices](https://diffusr.ai/docs/prices.md): What one second of video or one image costs through the diffusr API, next to what fal and other API sellers charge at the same setting.

## Guides

- [Callbacks](https://diffusr.ai/docs/callbacks.md): Pass a callback_url and we send one signed event when your job ends. Verify the signature, answer 2xx, ignore repeats.
- [Errors](https://diffusr.ai/docs/errors.md): Every error has a stable code. Branch on the code, not the message. This table is built from the API's own code list.
- [Limits](https://diffusr.ai/docs/limits.md): How many requests and jobs you can have at once. A request over a limit is refused with a Retry-After, never queued, never charged.
- [Uploads and media](https://diffusr.ai/docs/uploads.md): How to give a model a picture, a clip or a voice. Public links work directly; a local file goes up in two steps.
- [Templates](https://diffusr.ai/docs/templates.md): run_template makes a whole ad, template video, talking head or podcast as one job. List what is runnable, price it, run it.
- [Usage and data](https://diffusr.ai/docs/usage-and-data.md): What we keep, how long, how to delete it, and what you may and may not make. The binding terms are on diffusr.ai.

## SDKs

- [SDKs](https://diffusr.ai/docs/sdks.md): Two small clients with no dependencies. They send an Idempotency-Key for you, retry safely, wait for results and check callback signatures.

## For agents

- [MCP and skills](https://diffusr.ai/docs/mcp-and-skills.md): Connect the diffusr MCP server, and install the skills that teach an agent to price first and ask before spending.
- [llms.txt](https://diffusr.ai/docs/llms-txt.md): Every page here is also plain Markdown. Start from llms.txt.

## Reference

- [Reference](https://diffusr.ai/docs/reference.md): One page per route of the REST API, built from the same OpenAPI spec the app serves.
- [make_video](https://diffusr.ai/docs/reference/make_video.md): Make a video from a prompt
- [make_image](https://diffusr.ai/docs/reference/make_image.md): Make an image from a prompt
- [edit_image](https://diffusr.ai/docs/reference/edit_image.md): Edit a picture with a prompt
- [recast](https://diffusr.ai/docs/reference/recast.md): Recast a video clip
- [creator_video](https://diffusr.ai/docs/reference/creator_video.md): Make a video of a creator saying a script
- [make_music](https://diffusr.ai/docs/reference/make_music.md): Make a song from a prompt
- [run_template](https://diffusr.ai/docs/reference/run_template.md): Run a template
- [upload_asset](https://diffusr.ai/docs/reference/upload_asset.md): Upload a file to use as a reference
- [list_results](https://diffusr.ai/docs/reference/list_results.md): List your recent jobs
- [get_result](https://diffusr.ai/docs/reference/get_result.md): Get one job
- [cancel_result](https://diffusr.ai/docs/reference/cancel_result.md): Stop a job that has not finished
- [list_models](https://diffusr.ai/docs/reference/list_models.md): List models and their prices
- [list_creators](https://diffusr.ai/docs/reference/list_creators.md): List creators for creator_video
- [list_templates](https://diffusr.ai/docs/reference/list_templates.md): List the templates run_template can run
- [list_callbacks](https://diffusr.ai/docs/reference/list_callbacks.md): List callback deliveries
- [retry_callback](https://diffusr.ai/docs/reference/retry_callback.md): Retry a failed callback by hand
- [get_callback_secret](https://diffusr.ai/docs/reference/get_callback_secret.md): Get your callback signing secret
- [rotate_callback_secret](https://diffusr.ai/docs/reference/rotate_callback_secret.md): Make a new callback signing secret
- [ads_list_accounts](https://diffusr.ai/docs/reference/ads_list_accounts.md): List connected ad accounts
- [ads_list_creatives](https://diffusr.ai/docs/reference/ads_list_creatives.md): List creatives you can advertise
- [ads_list_campaigns](https://diffusr.ai/docs/reference/ads_list_campaigns.md): List campaigns with stats
- [ads_draft_launch](https://diffusr.ai/docs/reference/ads_draft_launch.md): Draft an ad launch
- [ads_get_launch](https://diffusr.ai/docs/reference/ads_get_launch.md): Get one ad launch

Site: https://diffusr.ai/docs