Create Note from Audio
Create a note from an audio file using a two-step process
Create a note from an audio file using a two-step process. First, generate a presigned URL for audio upload, then create the note from the uploaded audio.
This feature is available for Enterprise plans only. Both endpoints require Enterprise-level API keys.
Step 1: Generate Upload URL
POST /v1/notes/from-audio/generate-upload-url
Generate a presigned URL for uploading an audio file to our servers.
Request Body
File extension of the audio file. Options: m4a
, mp3
, wav
, aac
Duration of the audio file in seconds (maximum 4 hours / 14,400 seconds)
Response
The presigned URL for uploading the audio file to S3. This URL expires in 10 minutes.
The final URL where the audio file will be accessible after upload. Use this URL in Step 2.
Example Request
Example Response
Step 2: Upload Audio File
Use the presignedUrl
from Step 1 to upload your audio file directly to our servers.
Example Upload
Step 3: Create Note from Audio
POST /v1/notes/from-audio
Create a note from the uploaded audio file using the audioUrl from Step 1.
Request Body
The audio URL returned from Step 1 (generate upload URL)
Optional title for the note. If not provided, a title will be generated automatically.
Array of tag IDs to associate with the note
Type of meeting. Options: online
, in-person
, podcast
. Default:
in-person
Optional existing note ID to update instead of creating a new note
Response
The ID of the created note
Example Request
Example Response
Complete Workflow Example
Here’s a complete example of the audio-to-note conversion process:
Processing Status
After creating a note from audio, the note will go through several processing stages:
- transcript-processing: The audio is being transcribed
- summarizing: The transcript is being summarized and processed
- completed: The note is fully processed and ready
You can check the processing status by getting the note details using the returned noteId
.
Important Notes
- Audio files must be under 4 hours in duration
- Supported formats: M4A, MP3, WAV, AAC
- The presigned URL expires in 10 minutes after generation
- Processing time depends on audio length and quality
- Enterprise plan required for this feature