Skip to main content

HTML Quickstart

Developer Key

A rate-limited API developer key can be provisioned from the Sapling API dashboard. Developer keys allow for processing of 50,000 characters every 24 hours. Subscribe for production access and usage-based pricing.

The complete JavaScript API can be found under JavaScript -> Frontend Documentation.

Below is a minimal webpage using the Sapling SDK.

<html>
  <head>
    <script src="https://sapling.ai/static/js/sapling-sdk-v1.0.9.min.js"></script>
  </head>
  <body>
    <div contenteditable="true" id="check-space" sapling-ignore="true">Lets get started!</div>

    <script type="text/javascript">
      Sapling.init({
        key: '<api-key>',
        mode: 'dev',
      });

      const contentEditable = document.getElementById('check-space');
      Sapling.observe(contentEditable);
    </script>
  </body>
</html>
caution

Do not serve a page like this publicly, as it exposes the API key.

  • During development, you can pass in the API key and use Sapling's endpoints by setting mode: 'dev' in the init function.
  • For production, do not pass the API key in JavaScript. Instead, include the API key in your backend and call Sapling's endpoints from the backend. This is the default setting with mode: 'prod'.
  • See our Javascript Fullstack Quickstart for a complete example