# Reference

> One page per route of the REST API, built from the same OpenAPI spec the app serves.

Base address: `https://app.diffusr.ai/api/v2`. Send `Authorization: Bearer <key>` on every call except `GET /models`.

Raw spec (OpenAPI 3.1): https://app.diffusr.ai/api/v2/openapi.json

| Route | What it does |
| --- | --- |
| [`POST /api/v2/make_video`](https://diffusr.ai/docs/reference/make_video.md) | Make a video from a prompt |
| [`POST /api/v2/make_image`](https://diffusr.ai/docs/reference/make_image.md) | Make an image from a prompt |
| [`POST /api/v2/edit_image`](https://diffusr.ai/docs/reference/edit_image.md) | Edit a picture with a prompt |
| [`POST /api/v2/recast`](https://diffusr.ai/docs/reference/recast.md) | Recast a video clip |
| [`POST /api/v2/creator_video`](https://diffusr.ai/docs/reference/creator_video.md) | Make a video of a creator saying a script |
| [`POST /api/v2/make_music`](https://diffusr.ai/docs/reference/make_music.md) | Make a song from a prompt |
| [`POST /api/v2/run_template`](https://diffusr.ai/docs/reference/run_template.md) | Run a template |
| [`POST /api/v2/uploads`](https://diffusr.ai/docs/reference/upload_asset.md) | Upload a file to use as a reference |
| [`GET /api/v2/results`](https://diffusr.ai/docs/reference/list_results.md) | List your recent jobs |
| [`GET /api/v2/results/{id}`](https://diffusr.ai/docs/reference/get_result.md) | Get one job |
| [`POST /api/v2/results/{id}/cancel`](https://diffusr.ai/docs/reference/cancel_result.md) | Stop a job that has not finished |
| [`GET /api/v2/models`](https://diffusr.ai/docs/reference/list_models.md) | List models and their prices |
| [`GET /api/v2/creators`](https://diffusr.ai/docs/reference/list_creators.md) | List creators for creator_video |
| [`GET /api/v2/templates`](https://diffusr.ai/docs/reference/list_templates.md) | List the templates run_template can run |
| [`GET /api/v2/callbacks`](https://diffusr.ai/docs/reference/list_callbacks.md) | List callback deliveries |
| [`POST /api/v2/callbacks/{event_id}/retry`](https://diffusr.ai/docs/reference/retry_callback.md) | Retry a failed callback by hand |
| [`GET /api/v2/callbacks/secret`](https://diffusr.ai/docs/reference/get_callback_secret.md) | Get your callback signing secret |
| [`POST /api/v2/callbacks/secret/rotate`](https://diffusr.ai/docs/reference/rotate_callback_secret.md) | Make a new callback signing secret |
| [`GET /api/v2/ads/accounts`](https://diffusr.ai/docs/reference/ads_list_accounts.md) | List connected ad accounts |
| [`GET /api/v2/ads/creatives`](https://diffusr.ai/docs/reference/ads_list_creatives.md) | List creatives you can advertise |
| [`GET /api/v2/ads/campaigns`](https://diffusr.ai/docs/reference/ads_list_campaigns.md) | List campaigns with stats |
| [`POST /api/v2/ads/launches`](https://diffusr.ai/docs/reference/ads_draft_launch.md) | Draft an ad launch |
| [`GET /api/v2/ads/launches/{id}`](https://diffusr.ai/docs/reference/ads_get_launch.md) | Get one ad launch |

Source: https://diffusr.ai/docs/reference