{"files":{"SKILL.md":"---\nname: tisane-api-documentation\ndescription: \"Tisane API Documentation API skill. Use when working with Tisane API Documentation for parse, languages, helper. Covers 8 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Tisane API Documentation\n\n## Auth\nApiKey Ocp-Apim-Subscription-Key in header\n\n## Base URL\nhttps://api.tisane.ai\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /languages -- obtain a list of the languages supported by the service\n3. POST /parse -- create first parse\n\n## Endpoints\n8 endpoints across 8 groups. See references/api-spec.lap for full details.\n\n### Parse\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /parse | The method analyzes the input, returning high-level and low-level metadata (abusive & problematic fragments, sentiment snippets, entities, topics, phrase structure, parts of speech, etc |\n\n### Languages\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /languages | Obtain a list of the languages supported by the service |\n\n### Helper\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /helper/extract_text | A service method to remove JavaScript, CSS tags, JSON, and other markup, returning pure decoded text |\n\n### Compare\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /compare/entities | Compares two compound named entities and outputs the differences found |\n\n### Similarity\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /similarity | Calculate semantic similarity between two text fragments, in the same language or in two different languages |\n\n### DetectLanguage\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /detectLanguage | Detects the languages used in the specified text fragment |\n\n### Transform\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /transform | The method translates the input |\n\n### Lm\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /lm/inflections | List inflected forms |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a parse?\" -> POST /parse\n- \"List all languages?\" -> GET /languages\n- \"Create a extract_text?\" -> POST /helper/extract_text\n- \"Create a entity?\" -> POST /compare/entities\n- \"Create a similarity?\" -> POST /similarity\n- \"Create a detectLanguage?\" -> POST /detectLanguage\n- \"Create a transform?\" -> POST /transform\n- \"List all inflections?\" -> GET /lm/inflections\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Tisane API Documentation\n@base https://api.tisane.ai\n@auth ApiKey Ocp-Apim-Subscription-Key in header\n@endpoints 8\n@toc parse(1), languages(1), helper(1), compare(1), similarity(1), detectLanguage(1), transform(1), lm(1)\n\n@group parse\n@endpoint POST /parse\n@desc The method analyzes the input, returning high-level and low-level metadata (abusive & problematic fragments, sentiment snippets, entities, topics, phrase structure, parts of speech, etc\n@returns(200) {text: str, entities_summary: [map]}\n\n@endgroup\n\n@group languages\n@endpoint GET /languages\n@desc Obtain a list of the languages supported by the service\n\n@endgroup\n\n@group helper\n@endpoint POST /helper/extract_text\n@desc A service method to remove JavaScript, CSS tags, JSON, and other markup, returning pure decoded text\n\n@endgroup\n\n@group compare\n@endpoint POST /compare/entities\n@desc Compares two compound named entities and outputs the differences found\n@returns(200) {result: str, differences: [str]}\n\n@endgroup\n\n@group similarity\n@endpoint POST /similarity\n@desc Calculate semantic similarity between two text fragments, in the same language or in two different languages\n\n@endgroup\n\n@group detectLanguage\n@endpoint POST /detectLanguage\n@desc Detects the languages used in the specified text fragment\n@returns(200) {languages: [map]}\n\n@endgroup\n\n@group transform\n@endpoint POST /transform\n@desc The method translates the input\n\n@endgroup\n\n@group lm\n@endpoint GET /lm/inflections\n@desc List inflected forms\n@optional {language: str # (Required) The language code, lexeme: str # (Required) The lexeme to inspect, family: str # (Required) The family to inspect}\n\n@endgroup\n\n@end\n"}}