JSON definition · shared/definitions/ai-translation.json
View on GitHub
{
"title": {
"default": "Workshop registration",
"fr": "Inscription à l'atelier"
},
"description": "Choose a session and leave your contact details",
"elements": [
{
"type": "text",
"name": "full_name",
"title": "Full name",
"isRequired": true
},
{
"type": "text",
"name": "email",
"title": "Email address",
"inputType": "email",
"isRequired": true
},
{
"type": "radiogroup",
"name": "session",
"title": "Preferred session",
"isRequired": true,
"choices": [
{
"value": "morning",
"text": "Morning"
},
{
"value": "afternoon",
"text": "Afternoon"
}
]
}
]
}
Client · shared/client/ai-translation.js · sjs:ai-translation.client
View on GitHub
// Return translated strings in the original order, and always finish the callback
creator.onMachineTranslate.add(async (_, options) => {
showError("");
try {
const response = await fetch("/api/translate", {
method: "POST", headers: { "Content-Type": "application/json" },
body: JSON.stringify({ strings: options.strings, from: options.fromLocale, to: options.toLocale })
});
if (!response.ok) throw await responseError(response, "AI translation failed. Please try again.");
const strings = await response.json();
if (!Array.isArray(strings) || strings.length !== options.strings.length || strings.some(text => typeof text !== "string"))
throw new Error("The translation provider returned an invalid result. Please try again.");
options.callback(strings);
} catch (error) {
options.callback([]);
showError(`${translationError(error)} Existing translations are kept.`);
note(error.message, "error");
}
});
Server · app/routes/ai_translation.py · sjs:ai-translation.server
View on GitHub
# POST /api/translate — strings in, translated strings out (same order); nothing goes to SurveyJS
@router.post("/api/translate")
async def translate(body: TranslateRequest, settings: SettingsDep, translator: Translator) -> list[str]:
if not settings.ai_api_key:
raise HTTPException(501, "Set AI_API_KEY to enable translation")
translated = await translator.translate(body.strings, body.source, body.to) # any OpenAI-compatible provider
if not isinstance(translated, list) or len(translated) != len(body.strings) \
or not all(isinstance(text, str) for text in translated):
raise HTTPException(502, "The AI provider returned an unexpected answer")
return translated # what options.callback() takes