Skip to main content
Liquid AI builds small, fast Liquid Foundation Models (LFMs) and d1 decision models. The LFM models serve Chat Completions requests. The d1 models serve System One requests at /v1/systemone, the same API as Typesafe AI.
Liquid AI is a built-in provider you can pay for with credits, so a provider key is optional. Add your own Liquid AI key to bill usage to your Liquid AI account instead of your ngrok.ai credits.

​
Setup

1

Create an access key and add credits

Follow the quickstart to create an access key and purchase credits in app.ngrok.ai.
2

Store your Liquid AI API key (optional)

Skip this step to pay with credits. To bring your own key, create an API key in your Liquid AI account. Then add a provider key and create an access key configuration with a liquid routing rule that uses it.
3

Send requests

Send requests with your access key:

​
Chat models

  • lfm3-1.7b and lfm2.5-24b-a2b take text.
  • lfm3-vl-2b takes text and images.
  • lfm3-audio-2b and lfm3-omni-2b take audio input and can reply with audio. Set modalities and audio in the request to get an audio reply.
Liquid AI returns an error for top_p, so the gateway removes it before it sends the request and lists it in the Ngrok-AIG-Removed-Params response header.

​
Decision models

d1, d1.1, and d1-ultra answer typed questions instead of chatting. Send a POST request to /v1/systemone with a state and a questions object, as described in Typed-question APIs, and name a d1 model:
Liquid AI also accepts an images field on these requests and bills each image as input tokens. The gateway forwards model, state, questions, and images, and removes any other top-level field.

​
Available models

See the model catalog.

​
Next steps