기본 콘텐츠로 건너뛰기

Liquid d1.2 Tutorial: Classify and Route Without a Big LLM

Summary: Liquid AI's d1.2 and d1.2-ultra are "decision models": instead of writing an answer, they return probabilities for questions you define, such as "is this a complaint?", "which team should take this ticket?" or "what is the total on this invoice?". They bill input tokens only (d1.2 is $0.02 per million, d1.2-ultra $0.042), and output is free. This tutorial walks through a support-ticket router and an invoice reader built from the official docs, plus the cost math and the gotchas we found.

What a decision model is, and when it beats an LLM

A lot of "AI features" in real products are not writing tasks. They are bounded decisions: tag a message, pick a queue, rate urgency, pull a date out of a form, flag personal data. The usual approach is to prompt a chat model, ask it to reply in JSON, then parse and validate the text and hope the format holds. Liquid's decision models skip the text step. You send a state (the input: a message, a JSON object, an image or an audio clip) and a set of named questions, and the API returns typed answers with calibrated probabilities. The docs say the model answers all questions of a call at once, with zero generated tokens, which is why the response always reports output_tokens: 0.

That makes d1.2 a good fit when the set of possible answers is known in advance. It is a poor fit when you need free-form text: a reply draft, a summary, an explanation. For those you still want a generative model.

The question types you can ask

The decisions guide lists these types. The first three are the classic ones; the rest are new in d1.2 and d1.2-ultra (older d1 models return a 422 error on them).

  • Noul: one probability that the answer is yes. Use it for yes/no gates and moderation flags.
  • Choice: the most likely option, a confidence value and the full distribution. Use it for routing.
  • Score: a position on an ordered rubric you write (for example four urgency levels), with the distribution.
  • Choice with multiple: true: every option that applies, each with its own probability (they do not sum to 1).
  • Text, Number, Date: read one value from the input, with the exact characters and their position, or "not found".
  • Number with range: an estimate plus a 10th-90th percentile interval, for counts.
  • Spans: every passage of a kind, such as each piece of personal data, for redaction.
  • Box / Boxes: a rectangle around one object, or around every instance with a count; the request must contain exactly one image.

Step 1: Get a key and pick a client

  1. Create an organization in the Liquid console (console.liquid.ai) and generate a key under Dashboard > API Keys. Keys start with liquid_. Liquid's pricing page says every new organization starts with $2 in free credit.
  2. Store it as an environment variable, LIQUID_API_KEY, and keep it out of prompts and source files.
  3. Decide how you will call it. The endpoint is POST https://api.liquid.ai/decisions/v1/systemone and it implements TypeSafe's System One API, so the TypeSafe SDKs work (pip install typesafe-sdk or npm install @typesafe-ai/sdk) with the base URL https://api.liquid.ai/decisions.

Important: the docs state the SDKs can only read Noul, Choice and Score answers right now. They drop the new typed answers from the response, and a multiple-choice question makes the call fail. For invoice reading, spans, boxes, images or audio, call the endpoint over plain HTTP (for example Python requests). In TypeScript the docs also set compression: false, because the API does not accept zstd-compressed request bodies.

Step 2: Build a support-ticket router in one request

The docs' "Combining Question Types" example is the most practical starting point. One ticket goes in as a JSON string (message plus account fields such as plan and ARR), with three questions:

  • is_bug (Noul): is this a software bug rather than a usage question or account issue?
  • team (Choice): billing, engineering, frontend or account, each with a one-line description.
  • urgency (Score): Low / Medium / High, with SLA wording inside each level.

In Liquid's published response for a checkout crash blocking a $4,200 order, is_bug came back at 0.974, team picked engineering at 0.75 with frontend at 0.22 (confidence 0.66), and urgency scored 1.954 on the 0-2 scale. Those are the vendor's example numbers, not our test. The useful pattern is what you do with them in code:

  1. Treat is_bug > 0.7 as a bug.
  2. Escalate when it is a bug and urgency is above 1.5; prioritize when urgency is above 1.0; otherwise queue normally.
  3. When the team confidence drops below 0.5, log the runner-up option from probabilities and send the ticket to a human.

That last step is the real advantage over a parsed LLM reply. You get a number you can set a threshold on, instead of a label that sounds equally sure every time. Liquid's launch post reports calibration error of 0.8 points for d1.2-ultra and 1.2 for d1.2 across 13 benchmarks; that is a vendor claim, so check it on your own labeled tickets before you trust the thresholds.

Writing better criteria

  • Describe each Choice option by what belongs in it ("Charges, invoices, refunds, payment methods"), not just a one-word name.
  • Put the business rule inside Score levels ("handle within 4 hours"), so the scale means something to your team.
  • Pass structured context as JSON in the state. The ticket example includes the customer's plan and ARR, which the urgency question can weigh.

Step 3: Read values from an invoice

For extraction, use text, number and date questions over HTTP. The official example sends a four-line invoice and asks for payee, total, due date and VAT. The invoice does not show VAT, and the documented answer for vat is null with found: 0 rather than a guessed figure. Each found value also comes back with the original text and a span (character positions), so you can highlight where it was read from in a review screen.

Two behaviors to plan for:

  • Values are read, not converted. "1 234,50 EUR" returns 1234.5 with unit EUR; currency conversion is your job.
  • Dates follow the document. If the invoice says "03/04/2026 (day/month/year)", the answer is 2026-04-03. If your documents are ambiguous about date order, say so in the state.

For scanned invoices, send the image in the top-level images array as a base64 data URL. Liquid says an image costs 1.5 tokens per 32x32-pixel patch at the text rate, so a 1024x1024 scan is 1,536 tokens.

Step 4: Choose d1.2 or d1.2-ultra

Both use the same endpoint, request format and question types, and both accept text, images and audio with a 65,536-token input limit per question. Switching is one field: "model": "d1.2-ultra". Start on d1.2 and move a specific question to ultra only if your own labeled sample shows it misses. In Liquid's internal tests on the new tasks the gap is small (for example 98% vs 96% on reading receipt values, 93% vs 88% recall on finding personal data), and d1.2 even scored higher on picking every object in a photo (90% vs 87%).

Pricing and alternatives compared

All prices below are from Liquid's own docs and pricing page, checked on the date at the bottom of this post. The generative row is included as the "just use a small LLM" baseline from the same vendor.

Model Input / 1M tokens Output / 1M tokens Inputs Best for
d1.2 $0.02 $0 (no output) Text, images, audio Default for routing, gates, extraction
d1.2-ultra $0.042 $0 (no output) Text, images, audio Harder decisions where d1.2 misses
d1.1 / d1-ultra (deprecated) $0.02 / $0.042 $0 No audio, no typed answers Migrate: change model only
LFM3-1.7B (generative) $0.08 $0.20 Text When you need written text back

To make that concrete, we did the math for two jobs (see our cost table at the end of this post). Assuming roughly 600 billed tokens per ticket (our assumption, not a measurement), 100,000 tickets would cost about $1.20 on d1.2 and $2.52 on d1.2-ultra. For 10,000 scanned 1024x1024 invoices at about 1,836 tokens each, it is roughly $0.37 and $0.77. The $2 starter credit covers 100 million input tokens on d1.2. Note the per-request rule: the state, images and audio are billed once, and each extra question adds only its own tokens, so asking five questions in one call is much cheaper than five calls.

Editor's note

Good for: teams already paying a chat model to classify, route, score or pull fields out of text and scans, and anyone who wants a probability to set a review threshold on.

Not for: anything that needs a written reply, a summary or open-ended reasoning in the output.

Gotchas we found in the docs:

  • SDK silently drops typed answers. If total or pii is missing from your result, you are probably using the TypeSafe SDK; switch that call to plain HTTP.
  • 422 errors: sending a typed question to d1, d1.1 or d1-ultra returns 422. Validation errors also return 422, so check the model name first.
  • Box or boxes questions need exactly one image in the request.
  • spans and boxes read up to 16 items by default. If at_least is true, there may be more; raise max (up to 64). Each spans or boxes question costs about 250 to 415 tokens at the default, more as max grows.
  • Limits: up to 128 questions and 4.5 MB per request, 250,000 bytes of text per question. Korean, Japanese and Chinese text can hit the byte limit before the token limit.
  • Not on OpenRouter or Vercel yet for d1.2: the launch post says "coming soon", and the pricing page currently lists only Liquid for d1.2 and d1.2-ultra.

FAQ

Q: Does d1.2 ever generate text?
A: No. It returns probabilities, chosen options, scores and values read from the input (with their positions). Output tokens are always zero, which is why output is free.

Q: Can I keep my old d1 code?
A: Yes for Noul, Choice and Score. The docs say the request and response format is unchanged; change model from d1 or d1.1 to d1.2, or from d1-ultra to d1.2-ultra. The old models are deprecated and cannot do the new tasks or audio.

Q: Is there a free tier?
A: There is no ongoing free plan for the hosted API listed on the pricing page, but every new organization starts with $2 in credit. Liquid's separate open-weight decision models can be run on your own hardware under the LFM license, which is free below $10M annual revenue.

Related on lightmind24

If your "AI feature" is really a multiple-choice question, try answering it with a decision model before you pay a chat model to write JSON.

Images: screenshots of Liquid AI's d1 docs, decisions guide, d1.2 launch post and pricing page, plus our own cost table; see the official screenshots at the end of this post.

lightmind24 is an independent review site, not affiliated with Liquid AI.

Last verified: 2026-11-18
Sources:
Liquid AI Docs: d1.2
Liquid AI Docs: Decisions guide
Liquid AI blog: d1.2 launch (Nov 16, 2026)
Liquid AI pricing

Uploaded Image Uploaded Image Uploaded Image Uploaded Image Uploaded Image Uploaded Image

댓글

이 블로그의 인기 게시물

브루(Vrew) 요금제 정리: 무료 200크레딧으로 어디까지 쓸 수 있나

요약: 영상 자막 편집기 브루(Vrew)는 2026년 4월 22일부터 기능별 사용량 대신 '통합 크레딧' 하나로 요금을 매겨요. 무료 플랜은 매달 200크레딧이 들어오는데, 음성 분석(자동 자막)만 쓰면 최대 200분 분량이라 짧은 영상 몇 편은 충분하지만, 영상 초반의 Vrew 마크를 지우려면 유료 플랜이 필요해요. 이 글은 브루 공식 가격 페이지와 고객센터 공지를 2026년 10월 23일에 다시 확인해, 크레딧 계산법과 플랜 고르는 기준을 정리했어요. 목차 브루 요금 구조: 통합 크레딧이란 1크레딧으로 할 수 있는 일 무료 플랜으로 되는 것과 안 되는 것 유료 플랜 4종 비교표 월 구독·연 구독·기간 이용권, 무엇이 이득일까 상황별 추천: 학생·직장인·유튜버 크레딧이 모자랄 때: 사용 기록 지우개 업그레이드·환불 전에 알아둘 규칙 운영자 메모, 자주 묻는 질문 1. 브루 요금 구조: 통합 크레딧이란 예전 브루는 플랜마다 음성 분석 몇 분, AI 목소리 몇 자, 번역 몇 자처럼 기능별 한도를 따로 줬어요. 그런데 보이저엑스(브루 운영사)가 실제 이용 데이터를 보니 한두 가지 기능만 집중해서 쓰는 사람이 훨씬 많았다고 해요. 그래서 2026년 4월 22일 업데이트부터는 플랜마다 정해진 크레딧을 받고, 어떤 기능에 쓸지는 내가 정하는 방식으로 바뀌었어요. 플랜별 매달 지급량은 Free 200 · Light 2,000 · Standard 10,000 · Business 12,000크레딧 이에요. 공식 공지에 따르면 무료 사용자는 매달 1일에, 유료 사용자는 매월 결제일에 충전되고, 남은 크레딧은 다음 달로 넘어가지 않아요. 바뀐 뒤 무엇이 좋아졌나 공지에 나온 예시가 이해하기 쉬워요. Standard 플랜에서 AI 목소리만 쓰면 예전에는 최대 50만 자였지만, 지금은 1만 크레딧을 모두 AI 목소리에 몰아 쓸 수 있어 최대 100만 자가 돼요. 반대로 여러 기능을 골고루 쓰는 사람은 크레딧이 기능끼리 ...

에이닷 전화 vs 익시오: 통화 녹음·AI 요약, 내 통신사·폰에 맞는 앱 고르기

요약: 통화 녹음과 AI 요약을 쓰고 싶다면 먼저 내 통신사와 휴대폰 종류부터 확인해야 해요. LG유플러스 고객은 무료 앱 익시오, SKT 고객은 에이닷 전화가 가장 기능이 많고, 다른 통신사의 아이폰 사용자는 iOS에 들어 있는 기본 통화 녹음·전사 기능이 현실적인 선택이에요. 이 글은 2026-10-30에 SKT·LG유플러스·Apple 공식 페이지와 도움말을 직접 확인해 세 가지를 비교했어요. 왜 '앱 기능'보다 '내 조건'을 먼저 봐야 할까요 통화 요약 앱 비교 글을 보면 기능 목록부터 나열하는 경우가 많아요. 그런데 실제로 써 보려는 사람에게 가장 먼저 걸리는 건 기능이 아니라 이용 조건 이에요. 익시오는 LG유플러스 고객 전용이고, 에이닷 전화는 누구나 설치할 수 있지만 통역콜·baro 같은 기능은 SKT 고객에게만 열려 있어요. 아이폰은 운영체제 구조상 앱이 통화를 마음대로 녹음하기 어려워서, 통신사 앱이 안 되면 iOS 기본 기능에 기대야 해요. 그래서 이 글은 "어떤 앱이 제일 좋은가"보다 "내 통신사·내 폰에서 무엇을 쓸 수 있나" 순서로 정리했어요. 기능 차이는 그다음이에요. 한눈에 비교: 에이닷 전화 vs 익시오 vs 아이폰 기본 통화 녹음 구분 에이닷 전화 (SKT) 익시오 ixi-O (LG유플러스) 아이폰 기본 통화 녹음 (Apple) 누가 쓸 수 있나 통신사 구분 없이 앱 설치 가능. 단, 통역콜·baro·그룹통화 발신 등은 SKT 고객 전용 U+ 모바일 고객. 타 통신사, 만 14세 미만, 선불요금제 고객은 제한 (공식 사이트 FAQ상 알뜰폰 중 KB리브엠은 예외) 지원 국가·언어의 iPhone 사용자. 1명과 통화할 때만 녹음 가능 지원 OS·기기 Android 10 이상, iOS 16 이상 iOS 17 이상 iPhone 12 이상 / Android...

타입캐스트 vs 클로바더빙: 수익 나는 채널에 쓸 때 무료·유료 조건 비교

요약 타입캐스트와 클로바더빙은 둘 다 글만 입력하면 한국어 AI 목소리를 만들어 주는 서비스지만, 무료로 쓸 수 있는 범위가 꽤 다릅니다. 클로바더빙 무료는 매달 15,000자까지 쓸 수 있는 대신 수익이 생기는 채널에는 쓸 수 없고, 타입캐스트 무료는 처음에 주는 약 5분 분량의 다운로드로 끝나는 체험판에 가깝습니다. 광고 수익이 붙은 유튜브나 쇼핑몰 영상에 넣을 목소리라면 처음부터 유료 플랜 조건을 보고 고르는 편이 안전합니다. 왜 이 두 서비스를 같이 비교하나 쇼츠 내레이션, 수업 자료 더빙, 상품 소개 영상처럼 "내 목소리 대신 AI 목소리"가 필요할 때 한국 사용자들이 가장 많이 찾는 곳이 네오사피엔스의 타입캐스트 와 네이버의 클로바더빙 입니다. 기능 소개만 보면 비슷해 보이지만, 실제로 문제가 되는 건 음질보다 "이 목소리를 내 채널에 써도 되나" 입니다. 그래서 이 글은 기능 나열보다 무료 사용 범위, 출처 표기 의무, 유료 플랜 가격과 다운로드 한도를 중심으로 정리했습니다. 모든 수치는 2026년 10월 25일에 두 서비스의 공식 요금 페이지와 고객센터 도움말에서 직접 다시 확인한 내용입니다. 한눈에 보는 비교표 항목 타입캐스트 무료 타입캐스트 베이직 클로바더빙 Free 클로바더빙 Standard 월 요금 0원 9,900원 (연간 결제 시 10% 할인) 0원 19,900원 (네이버 클라우드 플랫폼에서 결제) 무료·포함 사용량 음성 생성·재생 무제한, 다운로드는 최초 3,000크레딧(약 5분) 1회 지급 월 30,000크레딧(약 60분) 월 15,000자, 다운로드 월 20회, 프로젝트 누적 5개 (매월 1일 갱신) 월 30,000자, 다운로드 월 40회, 프로젝트 누적 20개 쓸 수 있...