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 · examples/views/ai_translation.py · sjs:ai-translation.server
View on GitHub
# POST /api/translate — strings in, translated strings out (same order); nothing goes to SurveyJS
async def translate(request: HttpRequest) -> JsonResponse:
if not settings.AI_API_KEY:
return JsonResponse({"error": "Set AI_API_KEY to enable translation"}, status=501)
body = read_json(request)
strings = body.get("strings", []) if isinstance(body, dict) else None
if not isinstance(strings, list) or not all(isinstance(text, str) for text in strings):
return JsonResponse({"error": "Expected { strings, from, to }"}, status=400)
translated = await AiTranslation().translate(strings, body.get("from", ""), body.get("to", "")) # your provider
if not isinstance(translated, list) or len(translated) != len(strings) \
or not all(isinstance(text, str) for text in translated):
return JsonResponse({"error": "The AI provider returned an unexpected answer"}, status=502)
return JsonResponse(translated, safe=False) # what options.callback() takes