> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-developers/fileversions/recipes-available-via-url.md).

# Recipes available via URL

## Audio Snippets

Used to extract snippets from audio files

Extensions supported:

* aac
* aiff
* dts
* flac
* m4a
* mp2
* mp3
* oga
* ogg
* opus
* ra
* wav
* wma<br>

### Recipe Options

| key    | value                                |
| ------ | ------------------------------------ |
| format | \[string]                            |
| start  | timestamp to start snippet \[string] |
| end    | timestamp to end snippet \[string]   |

Timestamp in seconds, you may use dot notation to target in milliseconds.

Example: `{ format:"mp3", start:"0.305", end:"20.571" }`

### Usage

Usage of the audio snippet generation endpoint:

{% hint style="info" %}
also see the technical documentation under

* `{fylr base url}/inspect/apidocs/eas/download/`
* `{fylr base url}/inspect/apidocs/recipes/`
  {% endhint %}

#### Full Request Examples

**api/v1/objects/**

{% code overflow="wrap" %}

```
GET /api/v1/objects/uuid/{uuid}/file/id/{file}?recipe=audioconverter:snippet&recipe_params={params}
```

{% endcode %}

{% hint style="info" %}

* Find the a base URL to append a recipe to at the file field share menu in the detail view of a object
* To access the copyable deep links set the correct permissions for the deep link user[Export & Deep Links](/for-administrators/readme/export-and-deep-links.md)
  {% endhint %}

**api/v1/eas/download/**

{% code overflow="wrap" %}

```
GET /api/v1/eas/download/{fileId}/{hash}/{version}&access_token={access_token}&recipe=audioconverter:snippet&recipe_params={params}
```

{% endcode %}

* `/inspect/files/{fileID}` lists the required fields
* for `version` use a named rendition, like `original.mp3`
* alternatively, download the record in the frontend and copy the according download URL in the browsers dev tools
* use `&recipe=audioconverter:snippet` to use the recipe
* and pass the `recipe_params` as URL encoded JSON (depending on request context this might not be required)

<br>