curl --request POST \
--url https://api.totoy.ai/v1/explanation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"output_language": "en",
"language_level": "plain",
"source_id": "src_dmZ7imKLaPcQnv5ckvGlOEAA7",
"markdown_response": true
}
'{
"project_id": "pj_avX7imfLaPcQnv5ckvGlOEBA9",
"output_language": "en",
"language_level": "plain",
"source_id": "src_dmZ7imKLaPcQnv5ckvGlOEAA7",
"answer": {
"role": "assistant",
"content": "Hey!\nThis is a letter from the Austrian tax office.\nThey are informing you about your obligation to submit quarterly VAT returns if your annual turnover is more than €35,000.\nHowever, if you submit a VAT return for the month of January on time, you can choose to submit monthly returns instead.\nIf your annual turnover is more than €100,000, you are required to submit monthly VAT returns.\nSince your VAT returns and payments for 2021 do not cover the entire period, they are asking you to fill out the enclosed form to provide your actual annual turnover.\nThis is important to avoid sending you incorrect reminders.\nIf you have any questions, you can contact the service center at 050 233 233.\nTake care!"
},
"markdown_response": true
}Explains a document in any language
Explains a given document Source in any language in a specified output language and language level.
curl --request POST \
--url https://api.totoy.ai/v1/explanation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"output_language": "en",
"language_level": "plain",
"source_id": "src_dmZ7imKLaPcQnv5ckvGlOEAA7",
"markdown_response": true
}
'{
"project_id": "pj_avX7imfLaPcQnv5ckvGlOEBA9",
"output_language": "en",
"language_level": "plain",
"source_id": "src_dmZ7imKLaPcQnv5ckvGlOEAA7",
"answer": {
"role": "assistant",
"content": "Hey!\nThis is a letter from the Austrian tax office.\nThey are informing you about your obligation to submit quarterly VAT returns if your annual turnover is more than €35,000.\nHowever, if you submit a VAT return for the month of January on time, you can choose to submit monthly returns instead.\nIf your annual turnover is more than €100,000, you are required to submit monthly VAT returns.\nSince your VAT returns and payments for 2021 do not cover the entire period, they are asking you to fill out the enclosed form to provide your actual annual turnover.\nThis is important to avoid sending you incorrect reminders.\nIf you have any questions, you can contact the service center at 050 233 233.\nTake care!"
},
"markdown_response": true
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The ISO 639-1 code for the language in which the Explanation should be generated.
Supported Languages:
- ar: Arabic
- bs: Bosnian
- cs: Czech
- de: German
- es: Spanish
- en: English
- fa: Farsi
- fr: French
- hr: Croatian
- hu: Hungarian
- it: Italian
- pl: Polish
- ro: Romanian
- sk: Slovak
- sl: Slovenian
- sr: Serbian
- tl: Tagalog
- tr: Turkish
- uk: Ukrainian
- zh: Mandarin
ar, bs, cs, de, es, en, fa, fr, hr, hu, it, pl, ro, sk, sl, sr, tl, tr, uk, zh "en"
One of three language levels for the generated text:
- Simple Language: Answers are short and simple, using easy words and a clear structure.
- Plain Language: Answers are short and the assistant explains complicated terms.
- Detailed Language: Answers are not simplified and the assistant answers in detail.
simple, plain, detailed "plain"
The unique identifier of the uploaded Source to be used as context for the Explanation.
29^src_[a-zA-Z0-9]{25}$"src_dmZ7imKLaPcQnv5ckvGlOEAA7"
The conversation history. For an initial Explanation just provide an empty array or no messages. For follow-up questions, provide the entire conversation history.
50Show child attributes
Show child attributes
[]
Whether the response should be returned as Markdown formatted text. If 'false', the response will be returned in plain text.
true
Response
OK
The unique identifier of the Project this Explanation was assigned to. The Explanation will be assigned to the project_id of the Source.
28^pj_[a-zA-Z0-9]{25}$"pj_avX7imfLaPcQnv5ckvGlOEBA9"
The ISO 639-1 code for the language in which the Explanation should be generated.
Supported Languages:
- ar: Arabic
- bs: Bosnian
- cs: Czech
- de: German
- es: Spanish
- en: English
- fa: Farsi
- fr: French
- hr: Croatian
- hu: Hungarian
- it: Italian
- pl: Polish
- ro: Romanian
- sk: Slovak
- sl: Slovenian
- sr: Serbian
- tl: Tagalog
- tr: Turkish
- uk: Ukrainian
- zh: Mandarin
ar, bs, cs, de, es, en, fa, fr, hr, hu, it, pl, ro, sk, sl, sr, tl, tr, uk, zh "en"
One of three language levels for the generated text:
- Simple Language: Answers are short and simple, using easy words and a clear structure.
- Plain Language: Answers are short and the assistant explains complicated terms.
- Detailed Language: Answers are not simplified and the assistant answers in detail.
simple, plain, detailed "plain"
The unique identifier of the uploaded Source that was used as context for the Explanation.
29^src_[a-zA-Z0-9]{25}$"src_dmZ7imKLaPcQnv5ckvGlOEAA7"
Represents a message within an Explanation or a Knowledge Base Chat.
For Explanations - An assistant message is either an initial Explanation for the document when no messages were provided in the request or an answer to a user message in the provided conversation history.
Show child attributes
Show child attributes
{
"role": "assistant",
"content": "Hi!\nThe co-founders of Totoy are Benedikt Hielscher, Francis Rafal, Marcel Koller, Michael Perger and Simon Hoffmann.[R1]"
}
Whether the response is a Markdown formatted text.
true