Create Transcription

curl --request POST \
  --url https://easy-peasy.ai/api/transcriptions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "https://example.com/audiofile.mp3",
  "audio_type": "podcast",
  "language": "English",
  "name": "Interview with John Doe",
  "detect_speakers": true,
  "enhanced_quality": true
}
'

import requests

url = "https://easy-peasy.ai/api/transcriptions"

payload = {
    "url": "https://example.com/audiofile.mp3",
    "audio_type": "podcast",
    "language": "English",
    "name": "Interview with John Doe",
    "detect_speakers": True,
    "enhanced_quality": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: 'https://example.com/audiofile.mp3',
    audio_type: 'podcast',
    language: 'English',
    name: 'Interview with John Doe',
    detect_speakers: true,
    enhanced_quality: true
  })
};

fetch('https://easy-peasy.ai/api/transcriptions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://easy-peasy.ai/api/transcriptions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => 'https://example.com/audiofile.mp3',
    'audio_type' => 'podcast',
    'language' => 'English',
    'name' => 'Interview with John Doe',
    'detect_speakers' => true,
    'enhanced_quality' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://easy-peasy.ai/api/transcriptions"

	payload := strings.NewReader("{\n  \"url\": \"https://example.com/audiofile.mp3\",\n  \"audio_type\": \"podcast\",\n  \"language\": \"English\",\n  \"name\": \"Interview with John Doe\",\n  \"detect_speakers\": true,\n  \"enhanced_quality\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://easy-peasy.ai/api/transcriptions")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"https://example.com/audiofile.mp3\",\n  \"audio_type\": \"podcast\",\n  \"language\": \"English\",\n  \"name\": \"Interview with John Doe\",\n  \"detect_speakers\": true,\n  \"enhanced_quality\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://easy-peasy.ai/api/transcriptions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"https://example.com/audiofile.mp3\",\n  \"audio_type\": \"podcast\",\n  \"language\": \"English\",\n  \"name\": \"Interview with John Doe\",\n  \"detect_speakers\": true,\n  \"enhanced_quality\": true\n}"

response = http.request(request)
puts response.read_body

{
  "uuid": "4bc4e8ee-f29e-4a53-996e-5da955c42927",
  "dashboard_url": "https://easy-peasy.ai/audios/4bc4e8ee-f29e-4a53-996e-5da955c42927"
}

{
  "error": "Invalid input"
}

{
  "error": "Server error"
}

POST

api

transcriptions

Create Transcription

curl --request POST \
  --url https://easy-peasy.ai/api/transcriptions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "https://example.com/audiofile.mp3",
  "audio_type": "podcast",
  "language": "English",
  "name": "Interview with John Doe",
  "detect_speakers": true,
  "enhanced_quality": true
}
'

import requests

url = "https://easy-peasy.ai/api/transcriptions"

payload = {
    "url": "https://example.com/audiofile.mp3",
    "audio_type": "podcast",
    "language": "English",
    "name": "Interview with John Doe",
    "detect_speakers": True,
    "enhanced_quality": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: 'https://example.com/audiofile.mp3',
    audio_type: 'podcast',
    language: 'English',
    name: 'Interview with John Doe',
    detect_speakers: true,
    enhanced_quality: true
  })
};

fetch('https://easy-peasy.ai/api/transcriptions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://easy-peasy.ai/api/transcriptions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => 'https://example.com/audiofile.mp3',
    'audio_type' => 'podcast',
    'language' => 'English',
    'name' => 'Interview with John Doe',
    'detect_speakers' => true,
    'enhanced_quality' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://easy-peasy.ai/api/transcriptions"

	payload := strings.NewReader("{\n  \"url\": \"https://example.com/audiofile.mp3\",\n  \"audio_type\": \"podcast\",\n  \"language\": \"English\",\n  \"name\": \"Interview with John Doe\",\n  \"detect_speakers\": true,\n  \"enhanced_quality\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://easy-peasy.ai/api/transcriptions")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"https://example.com/audiofile.mp3\",\n  \"audio_type\": \"podcast\",\n  \"language\": \"English\",\n  \"name\": \"Interview with John Doe\",\n  \"detect_speakers\": true,\n  \"enhanced_quality\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://easy-peasy.ai/api/transcriptions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"https://example.com/audiofile.mp3\",\n  \"audio_type\": \"podcast\",\n  \"language\": \"English\",\n  \"name\": \"Interview with John Doe\",\n  \"detect_speakers\": true,\n  \"enhanced_quality\": true\n}"

response = http.request(request)
puts response.read_body

{
  "uuid": "4bc4e8ee-f29e-4a53-996e-5da955c42927",
  "dashboard_url": "https://easy-peasy.ai/audios/4bc4e8ee-f29e-4a53-996e-5da955c42927"
}

{
  "error": "Invalid input"
}

{
  "error": "Server error"
}

Complete Workflow

Transcription is asynchronous — after submitting an audio file, you need to poll for results. Here’s the full workflow:

Step 1: Submit audio for transcription

Use this endpoint to upload your audio file. The response includes a uuid you’ll need for the next steps.

Transcription typically takes 1–5 minutes depending on audio length. Save the uuid from the response.

Step 2: Poll for results

Use Get Transcription Result to check if the transcription is complete. Poll every 15–30 seconds until the content field is populated. The transcription is ready when the response includes a non-empty content field and a segments array with timestamped text.

async function waitForTranscription(uuid, apiKey) {
  const maxAttempts = 40; // ~10 minutes max

  for (let i = 0; i < maxAttempts; i++) {
    const response = await fetch('https://easy-peasy.ai/api/audios', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': apiKey
      },
      body: JSON.stringify({ audio_id: uuid })
    });

    const data = await response.json();

    if (data.audio.content) {
      return data; // Transcription complete!
    }

    await new Promise(resolve => setTimeout(resolve, 15000));
  }

  throw new Error('Transcription timeout');
}

Step 3: Generate AI content (optional)

Once the transcription is complete, use Generate Audio Content to create summaries, titles, action items, and more.

curl -X POST https://easy-peasy.ai/api/generate-audio-content \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"audio_id": "YOUR_AUDIO_UUID"}'

You can also generate specific fields only:

curl -X POST https://easy-peasy.ai/api/generate-audio-content \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "audio_id": "YOUR_AUDIO_UUID",
    "fields": ["summary", "title", "keywords"]
  }'

Content generated depends on the audio type:

Audio Type	Fields
Meeting	summary, title, description, action items, keywords, timestamped overview, topics & bullets, LinkedIn post
Podcast	summary, title, description, show notes, Twitter thread, article, newsletter, keywords, questions, LinkedIn post, timestamped overview, topics & bullets
Therapy Session	summary, title, description, progress note, SOAP note, DAP note, keywords, timestamped overview, topics & bullets, LinkedIn post

Authorizations

x-api-key

string

header

required

API key for authentication. Get yours at https://easy-peasy.ai/settings/api

Headers

x-api-key

string

required

Your API key

Body

application/json

The audio parameters to create transcriptions

url

string

required

The URL of the audio file

Example:

"https://example.com/audiofile.mp3"

audio_type

string

The type of audio (e.g., podcast, meeting)

Example:

"podcast"

language

string

The language of the audio (e.g., English, Chinese, French)

Example:

"English"

name

string

The name of the transcription

Example:

"Interview with John Doe"

detect_speakers

boolean

Whether to detect multiple speakers

Example:

true

enhanced_quality

boolean

Whether to use enhanced quality for transcription

Example:

true

Response

Successful transcription creation

uuid

string

Unique identifier for the created transcription

Example:

"4bc4e8ee-f29e-4a53-996e-5da955c42927"

dashboard_url

string

URL of the generated transcription

Example:

"https://easy-peasy.ai/audios/4bc4e8ee-f29e-4a53-996e-5da955c42927"

Getting Started

Text Generation

Image Generation

Video Generation

Transcription

Text-to-Speech

Sound Effects

Chat Completions

Bots

Create Transcription

Complete Workflow

Step 1: Submit audio for transcription

Step 2: Poll for results

Step 3: Generate AI content (optional)

Authorizations

Headers

Body

Response

​Complete Workflow

​Step 1: Submit audio for transcription

​Step 2: Poll for results

​Step 3: Generate AI content (optional)

Authorizations

Headers

Body

Response

Complete Workflow

Step 1: Submit audio for transcription

Step 2: Poll for results

Step 3: Generate AI content (optional)