Three examples, with measured numbers

Every number on this page comes from a real call to the public API, made on 22 September 2026 and repeated three times. Nothing is estimated. The code can be copied and run: if your numbers differ from ours, that difference is information, and we want to know about it.

All you need is a key and your base_url:

export API_KEY="sk-siati-…"
export BASE_URL="https://api.ai.itsincom.org/v1"

1. Extracting the fields of an invoice#

A fiduciary's case: a supplier invoice becomes a bookkeeping entry. With json_schema the answer is an object with those fields and those types, not "usually".

curl $BASE_URL/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-4-26b",
    "temperature": 0,
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "invoice",
        "schema": {
          "type": "object",
          "properties": {
            "document_number": {"type": "string"},
            "issue_date":      {"type": "string"},
            "due_date":        {"type": "string"},
            "supplier":        {"type": "string"},
            "net_amount":      {"type": "number"},
            "vat_rate":        {"type": "number"},
            "vat_amount":      {"type": "number"},
            "total":           {"type": "number"},
            "iban":            {"type": "string"}
          },
          "required": ["document_number","issue_date","supplier","net_amount","total"]
        }
      }
    },
    "messages": [
      {"role":"system","content":"Extract the fields from the invoice. Amounts as numbers, without apostrophes."},
      {"role":"user","content":"FATTURA N. 2026-0417\nStudio Bernasconi SA, Via Nassa 12, 6900 Lugano\nData: 14 settembre 2026 — Scadenza: 14 ottobre 2026\nImponibile CHF 4'\''650.00\nIVA 8.1% CHF 376.65\nTOTALE CHF 5'\''026.65\nIBAN CH93 0076 2011 6238 5295 7"}
    ]
  }'

What comes back:

{
  "document_number": "2026-0417",
  "issue_date": "14 settembre 2026",
  "due_date": "14 ottobre 2026",
  "supplier": "Studio Bernasconi SA",
  "net_amount": 4650.0,
  "vat_rate": 8.1,
  "vat_amount": 376.65,
  "total": 5026.65,
  "iban": "CH93 0076 2011 6238 5295 7"
}

Measured — three runs, identical:

Fields checked one by one against the document: number, net amount, VAT amount, total and rate, all correct in all three runs.

What we do not guarantee, and should say. The schema constrains the shape, not the truth: total is always there and will be a number; whether it is the total is for your check to say. Add up the lines and compare. And on a Swiss invoice with the payment part, read the QR code first: IBAN, reference, amount and creditor come out deterministically, without a model. Use the model for what the code does not contain.

2. Querying your documents, with the source#

⚠️ Correction of 1 October 2026. Until that day this section showed three curl commands to /v1/rag/kb with the API key. Those commands answer 404: today document search is used from the dashboard (https://my.ai.itsincom.org) and from the app, not from the key-based API. We had written them without testing them from outside, which is exactly what this page promises not to do. We removed them instead of replacing them with others not tested. The numbers below remain true: they are measured on the pipeline, not on the commands.

What comes back — on a five-article mandate contract:

Ciascuna parte può disdire il contratto con un preavviso di sei mesi per la fine di un anno civile [contratto-mandato.md: parte 0]. La disdetta deve essere comunicata per iscritto mediante raccomandata [contratto-mandato.md: parte 0].

The citation is not decoration: it is the point. An answer without a source, on a contract, cannot be used by whoever has to answer the client.

Measured — three different questions on the same contract:

The three questions — notice period, deadline for adjusting the fee, yearly amount and instalments — all got the right answer with the article cited.

⚠️ On 22 September 2026 document upload was not in service: the object storage that receives the files had a fault since 12 September. The numbers above measure the real pipeline — reading, splitting, vectors, search, rerank, answer — with the document provided another way. On 3 October 2026 the object storage was replaced; we are re-verifying the upload end to end, and this note will go, with the date. If your case is field extraction (example 1), it does not concern you.

3. Transcribing a meeting#

curl $BASE_URL/audio/transcriptions \
  -H "Authorization: Bearer $API_KEY" \
  -F file=@minutes.wav \
  -F model=whisper-1 \
  -F response_format=verbose_json \
  -F "timestamp_granularities[]=word"

Measured on 22.2 seconds of minutes in Italian:

⚠️ On cost, correction of 1 October 2026. This page used to say CHF 0.36 for an hour of audio, which is the configured price. Checking the usage records we found that transcription is not billed at all today, and that the public price list shows a third value (CHF 0.24 per hour). Until the three figures match we write none of them: the price will come back here when it is the same in the price list, in the configuration and on the invoice.

A useful thing we did not expect to have to document: spoken numbers come out as digits.

«…un utile di 47.000 franchi. Secondo punto, la fattura numero 2026-0417 dello studio Bernasconi, da 5.026 franchi e 65, va registrata entro il 14 ottobre.»

Dictated as "quarantasettemila", "cinquemilaventisei franchi e sessantacinque", "quattordici ottobre". In minutes that is exactly what you need, and it means the text can go straight into example 1 to extract its fields.

Per-word timings are for whoever has to highlight the exact point in the audio, cut a recording or show where recognition was uncertain — the probability is per word:

{"start": 21.44, "end": 22.02, "word": " ottobre.", "probability": 0.9997}

How these numbers were obtained#

Three calls per example, from outside, through the load balancer, with a normal key and the medium tier. Latency is the total time of the HTTP request, not the model's time alone: it includes network, authentication, accounting and response. The cost is computed with the real billing formula, which since 3 October 2026 is also the one shown on the pricing page.

The numbers change with the length of your document, the tier of the key and the load. Measure on your own case: that is why the code is here and not only the table.