Create anecdote from audio - YALG Developer Docs

Create anecdote from audio

curl --request POST \
  --url https://api.yalg.ai/v1/anecdotes/audio \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form audio='@example-file'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "My Experience at the Tech Conference",
  "content": "Transcribed and processed content from audio...",
  "authorId": "987fcdeb-51a2-43d7-8f9e-123456789abc",
  "tags": [
    "conference",
    "networking"
  ],
  "priority": 1,
  "isActive": true,
  "createdAt": "2024-01-15T10:30:00Z"
}

POST

/

v1

/

anecdotes

/

audio

Create anecdote from audio

curl --request POST \
  --url https://api.yalg.ai/v1/anecdotes/audio \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form audio='@example-file'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "My Experience at the Tech Conference",
  "content": "Transcribed and processed content from audio...",
  "authorId": "987fcdeb-51a2-43d7-8f9e-123456789abc",
  "tags": [
    "conference",
    "networking"
  ],
  "priority": 1,
  "isActive": true,
  "createdAt": "2024-01-15T10:30:00Z"
}

Authorizations

x-api-key

string

header

default:yalg_live_your_api_key

required

YALG Developer API key. Send it in the x-api-key header from a server-side environment only.

Query Parameters

autoFill

boolean

Enable AI auto-fill for missing details

Example:

false

Body

multipart/form-data

audio

file

required

Audio file (mp3, wav, m4a, etc.)

priority

number

default:1

Priority level (1 = highest, 5 = lowest)

Required range: 1 <= x <= 5

title

string

Optional title to keep when autoFill is disabled

storyType

string

Optional story type

tags

string

JSON array of tags, for example ["leadership"]

contentScopes

string

JSON array of content scopes, for example ["linkedin"]

mood

string

Optional mood/tone

context

string

Optional context around the anecdote

lessonLearned

string

Optional lesson learned

linkedinAngle

string

Optional LinkedIn angle

isFavorite

enum<string>

Whether the anecdote starts as favorite

Available options:

true,

false

timeSensitive

enum<string>

Whether the anecdote is time-sensitive

Available options:

true,

false

Response

Audio anecdote processed and created successfully

⌘I