Translation config API

Named AI-notes / translation presets, wiring together your STT, LLM and TTS credentials.

Endpoint: https://mediasfu.com/v1/translationconfigs

Authenticate with Authorization: Bearer <api-username>:<api-key> from your server. Try every action and copy the request in the API Sandbox.

Create a config

POST https://mediasfu.com/v1/translationconfigs with action: "create"

Wire STT + LLM + TTS credentials into a named preset.

Required fields

Field	Type	Description	Default
nickName	text	Config nickname
sttNickName	text	STT credential. Nickname of a stored STT credential.
llmNickName	text	LLM credential. Nickname of a stored LLM credential.
ttsNickName	text	TTS credential. Nickname of a stored TTS credential.

curl -X POST https://mediasfu.com/v1/translationconfigs \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MEDIASFU_API_USERNAME:$MEDIASFU_API_KEY" \
  -d '{"action":"create","nickName":"meeting-notes-en","sttNickName":"your-stt-nick-name","llmNickName":"your-llm-nick-name","ttsNickName":"your-tts-nick-name"}'

Update a config

POST https://mediasfu.com/v1/translationconfigs with action: "update"

Change a config, identified by nickname.

Required fields

Field	Type	Description	Default
nickName	text	Config nickname

Optional: Changes

Swap any of the wired credentials.

Field	Type	Description	Default
sttNickName	text	STT credential. Nickname of a stored STT credential.
llmNickName	text	LLM credential. Nickname of a stored LLM credential.
ttsNickName	text	TTS credential. Nickname of a stored TTS credential.

curl -X POST https://mediasfu.com/v1/translationconfigs \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MEDIASFU_API_USERNAME:$MEDIASFU_API_KEY" \
  -d '{"action":"update","nickName":"meeting-notes-en"}'

Delete a config

POST https://mediasfu.com/v1/translationconfigs with action: "delete"

Remove a translation config.

Required fields

Field	Type	Description	Default
nickName	text	Config nickname

curl -X POST https://mediasfu.com/v1/translationconfigs \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MEDIASFU_API_USERNAME:$MEDIASFU_API_KEY" \
  -d '{"action":"delete","nickName":"meeting-notes-en"}'

List / get

GET https://mediasfu.com/v1/translationconfigs with action: "get"

Retrieve records. Everything is optional — send as-is to list all.

No fields are required.

Optional: Filters

All optional — narrow or page the results.

Field	Type	Description	Default
startIndex	number	Start index	0
pageSize	number (1–100)	Page size	20

curl "https://mediasfu.com/v1/translationconfigs?action=get" \
  -H "Authorization: Bearer $MEDIASFU_API_USERNAME:$MEDIASFU_API_KEY"

See errors and response format for failure handling.