Text focused APIs utilizing generative large language models (LLMs)
MARCIE API (2025-08-18T18:01:56Z)
Lets documents, content and metadata be stored in MARCIE for further API processing. To get this data into the MARCIE store, document decomposition and ingestion, as well as manual document/content submission APIs can be used. Once populated, application APIs provide semantic/syntactic analysis, semantic search and content related querying to be executed at scale. See APPS from the navigation panel for more details.
Content is submitted to endpoints with associated control attributes and results are synchronously returned. Primary examples of these APIs include: content comparison, enrichment, transformation, and analysis (spellcheck, grammar, sentiment, readability). See DOCUMENT and CONTENT from the navigation panel for more details. In this scenario, content is not stored or persisted.
https://marcie.redocly.app/_mock/openapi/
https://w1waoh1clk.execute-api.us-east-1.amazonaws.com/{basePath}/
Controls the amount of randomness in the generated text. Lowering this will result in the output to be more deterministic.
- Mock server
https://marcie.redocly.app/_mock/openapi/text/enrichment/plainlang/rewrite
https://w1waoh1clk.execute-api.us-east-1.amazonaws.com/semantex-qa/text/enrichment/plainlang/rewrite
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://marcie.redocly.app/_mock/openapi/text/enrichment/plainlang/rewrite \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"text": "Quantum mechanics is a basic theory in physics that explains how things work at the tiny scale of atoms and subatomic particles. It is the basis for all quantum physics, like quantum chemistry, quantum field theory, quantum technology, and quantum information science."
}'
{}
The target grade level.
Controls the amount of randomness in the generated text. Lowering this will result in the output to be more deterministic.
- Mock server
https://marcie.redocly.app/_mock/openapi/text/enrichment/readability/rewrite
https://w1waoh1clk.execute-api.us-east-1.amazonaws.com/semantex-qa/text/enrichment/readability/rewrite
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://marcie.redocly.app/_mock/openapi/text/enrichment/readability/rewrite \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"text": "These methods still require supervised training in order to perform a task. When only minimal or no supervised data is available, another line of work has demonstrated the promise of language models to perform specific tasks, such as common sense reasoning (Schwartz et al., 2017) and sentiment analysis (Radford et al., 2017). In this paper, we connect these two lines of work and continue the trend of more general methods of transfer. We demonstrate language models can perform down-stream tasks in a zero-shot setting – without any parameter or architecture modification. We demonstrate this approach shows potential by highlighting the ability of language models to perform a wide range of tasks in a zero-shot setting. We achieve promising, competitive, and state of the art results depending on the task.",
"target": "5"
}'
{}
Controls the amount of randomness in the generated text. Lowering this will result in the output to be more deterministic.
- Mock server
https://marcie.redocly.app/_mock/openapi/text/summary
https://w1waoh1clk.execute-api.us-east-1.amazonaws.com/semantex-qa/text/summary
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://marcie.redocly.app/_mock/openapi/text/summary \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"text": "Jupiter is the fifth planet from the Sun and the largest in the Solar System. It is a gas giant with a mass one-thousandth that of the Sun, but two-and-a-half times that of all the other planets in the Solar System combined. Jupiter is one of the brightest objects visible to the naked eye in the night sky, and has been known to ancient civilizations since before recorded history. It is named after the Roman god Jupiter.[19] When viewed from Earth, Jupiter can be bright enough for its reflected light to cast visible shadows,[20] and is on average the third-brightest natural object in the night sky after the Moon and Venus."
}'
{}
Enrichments/Classification
Text enrichment APIs offer various enrichment functions that take the raw text as its input and provides a specific enrichment/feature corresponding to the input text. An enrichment function is idempotent and its output is determined by the input text and the underlying predictive (deep learning based) linguistic model. Some examples of these include text based sentiment, readability calculation etc. Most of the underlying methods can be used either using a "GET" or a "POST" HTTP method. For smaller text, the GET method offers better performance and allows for network optimizations such as caching.