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"}'
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
| 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"}'
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
| 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"}'
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.
| Field | Type | Description | Default |
|---|---|---|---|
startIndex | number | Start index | 0 |
pageSize | number (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.