Skip to main content

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​

FieldTypeDescriptionDefault
nickNametextConfig nickname
sttNickNametextSTT credential. Nickname of a stored STT credential.
llmNickNametextLLM credential. Nickname of a stored LLM credential.
ttsNickNametextTTS 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"}'

Example response:

{
"success": true,
"translationConfig": {
"nickName": "meeting-notes-en",
"description": "",
"status": "ACTIVE",
"sttNickName": "my-stt",
"llmNickName": "my-llm",
"ttsNickName": "my-tts",
"translationOutputMode": null,
"aiNoteTakerConfig": null,
"languages": {},
"voiceOverrides": [],
"extra": []
}
}

Update a config​

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

Change a config, identified by nickname.

Required fields​

FieldTypeDescriptionDefault
nickNametextConfig nickname

Optional: Changes​

Swap any of the wired credentials.

FieldTypeDescriptionDefault
sttNickNametextSTT credential. Nickname of a stored STT credential.
llmNickNametextLLM credential. Nickname of a stored LLM credential.
ttsNickNametextTTS 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"}'

Example response:

{
"success": true,
"translationConfig": {
"nickName": "meeting-notes-en",
"llmNickName": "my-llm-2",
"…": "same fields as create"
}
}

Delete a config​

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

Remove a translation config.

Required fields​

FieldTypeDescriptionDefault
nickNametextConfig 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"}'

Example response:

{
"success": true,
"translationConfig": {
"nickName": "meeting-notes-en",
"deleted": true
}
}

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.

FieldTypeDescriptionDefault
startIndexnumberStart index0
pageSizenumber (10–50)Page size. Between 10 and 50.20
curl "https://mediasfu.com/v1/translationconfigs?action=get" \
-H "Authorization: Bearer $MEDIASFU_API_USERNAME:$MEDIASFU_API_KEY"

Example response:

{
"success": true,
"translationConfigs": [
{
"nickName": "meeting-notes-en",
"status": "ACTIVE",
"…": "same fields as create"
}
],
"total": 1,
"totalCount": 1,
"startIndex": 0,
"pageSize": 10
}

See errors and response format for failure handling.