> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an AI doc from a file, a recording or YouTube

> Create an AI doc in Hamsa Media: pick a template, add a file, a recording or a YouTube link, set the languages and instructions, and follow its status.

You create an AI doc in two steps: add the audio and its details, then tell the AI anything it should know. Hamsa transcribes the audio and writes the document, and it appears in **Jobs** when it's ready.

## Before you start

* Credits left on the project owner's account. A doc costs 2 credits a minute of audio, taken once it's written. See [Billing](https://docs.tryhamsa.com/overview/billing.md).

## Create a doc

**1. Pick a template**

Open **AI docs** in the sidebar and click a card under **Templates**: **Social media posts**, **Summary and keywords**, **Web article (SEO)** or **FAQ**. The dialog opens with the template's name as its title.

You can also press Cmd+K (Ctrl+K on Windows), choose **Create an AI doc**, then the template.

![The command palette after Create an AI doc, listing the four templates](https://mintcdn.com/hamsa-452fa79a/7GY0-8K2sfzXu6G7/images/media/ai-docs/command-palette-create-light.webp?fit=max\&auto=format\&n=7GY0-8K2sfzXu6G7\&q=85\&s=e401eb99655836d23a65b4f6cfa2f772)

**2. Name it and date it**

Enter a **Title**. **Date** is when the audio was recorded; it starts at today, and you can't pick a day in the future.

**3. Set the languages**

Choose the **Audio language**, Arabic or English, and the **Document language**: Arabic, English, **Both, Arabic first** or **Both, English first**. Both start at Arabic.

**4. Add the audio**

Under **Audio source**, choose **File**, **Recording** or **YouTube link**, then add the audio. See [Audio sources](#audio-sources). Click **Next**.

![The Summary and keywords dialog on Step 1: Title, Date, Audio language and Document language set to Arabic, and an audio file added under Audio source](https://mintcdn.com/hamsa-452fa79a/7GY0-8K2sfzXu6G7/images/media/ai-docs/create-dialog-audio-light.webp?fit=max\&auto=format\&n=7GY0-8K2sfzXu6G7\&q=85\&s=43e8205145ecb6de5d254c59afa8d1d9)

**5. Add instructions (optional)**

In **Instructions**, describe the audience, the participants and the purpose. The AI follows them when it writes. They take up to 5,000 characters; the counter under the box shows how many you've used.

![Step 2 of the dialog: Instructions filled in with the audience, the participants and the purpose, and the Create button](https://mintcdn.com/hamsa-452fa79a/7GY0-8K2sfzXu6G7/images/media/ai-docs/create-dialog-instructions-light.webp?fit=max\&auto=format\&n=7GY0-8K2sfzXu6G7\&q=85\&s=893bf0749d30731d500ab53682cf1f21)

**6. Create**

Click **Create**. "The AI doc is being created." confirms it, and the doc appears in **Jobs** as **Pending**.

If you switch the audio source after adding audio, the dialog asks before it discards it. If you close the dialog with changes, it asks first too.

### Start from a dropped file

Drop one audio file anywhere on the **AI docs** page. A line says the file is ready; click a template and the file is already in the dialog.

## Audio sources

| Source | Limits | Good to know |
| - | - | - |
| **File** | MP3, WAV, M4A, WEBM, OGG, AAC or FLAC. Up to 32 MB and under 2 hours. One file. | The file is checked when you pick it: "This file is over 32 MB. Upload a smaller one.", "The file must be under 2 hours." |
| **Recording** | At least 30 seconds. | Press **Start recording**, then **Pause**, **Resume** or **Stop**, and **Play** to listen back. The browser asks for the microphone. |
| **YouTube link** | A youtube.com or youtu.be link, video up to 1 hour. | A preview of the video shows under the link. A longer video is refused when you click **Create**. |

## Statuses

| Status | What it means | What you can do |
| - | - | - |
| **Pending** | Hamsa is transcribing the audio or writing the document. | Wait. The list and the activity tray update by themselves. |
| **Completed** | The document is ready. | Click the row to open it. |
| **Failed** | The doc couldn't be made. | Create it again. |

![The Jobs table with docs that are Pending, Completed and Failed, with Search jobs, Filter and Display above it](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/ai-docs/jobs-table-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=df5fa02aefb86ba0431d443a2d62d963)

Only a **Completed** doc opens; **View** and **Delete** in the row menu wait until then. When a doc finishes, the notifications bell and the activity tray tell you ("Your AI doc ... is ready"). See [Activity and notifications](https://docs.tryhamsa.com/media/workspace/activity-and-notifications.md).

## Find, rename and delete docs

* **Jobs** lists your docs with **Title**, **Status** and **Created**, newest first. Search by title with **Search jobs**, or filter by status. See [Lists and uploads](https://docs.tryhamsa.com/media/workspace/lists-and-uploads.md) for saved views and selecting several rows.
* To rename a doc, open it and click the pencil next to its title. Press Enter to save or Escape to cancel. Titles can be up to 150 characters.
* To delete a doc, open the row menu and click **Delete**, then confirm. The doc leaves the list at once, and you can undo for a few seconds. Select several rows to delete them together.

![The row menu of a completed doc open, with View and Delete](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/ai-docs/row-menu-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=0cf7a68e555f3294507196678607013d)

## Good to know

* A doc is made from one template. For another kind of document from the same audio, create a new doc.
* There is no regenerate. To try different instructions, create a new doc.
* The doc's header line shows where the audio came from (**Uploaded file**, **YouTube** or **Recording**) and the date it was last changed.

## Related

> [card] [Edit a doc](https://docs.tryhamsa.com/media/ai-docs/edit-a-doc.md)
>
> Change the text, blocks and tables.

> [card] [AI docs](https://docs.tryhamsa.com/media/ai-docs/overview.md)
>
> Templates, languages and credits.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.