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 · src/main/java/io/surveyjs/examples/AiTranslationController.java · sjs:ai-translation.server
View on GitHub
// POST /api/translate — strings in, translated strings out (same order); nothing goes to SurveyJS
@PostMapping("/api/translate")
public JsonNode translate(@RequestBody TranslateRequest body) {
if (settings.aiApiKey() == null) {
throw new ResponseStatusException(HttpStatus.NOT_IMPLEMENTED, "Set AI_API_KEY to enable translation");
}
JsonNode translated = ai.translate(body.strings(), body.from(), body.to()); // any OpenAI-compatible provider
if (translated == null || !translated.isArray() || translated.size() != body.strings().size()
|| !translated.valueStream().allMatch(JsonNode::isString)) {
throw new ResponseStatusException(HttpStatus.BAD_GATEWAY, "The AI provider returned an unexpected answer");
}
return translated; // what options.callback() takes
}