Diatts

Notes on open-source speech synthesis

Data & Practice

How to read a speech model card

Model documentation is written to be skimmed and is most useful when it is not. A short guide to the sections that actually constrain what you can do.

Published May 4, 2026 · Updated May 6, 2026 · Filed under Data & Practice

A model card is the document published alongside a released model that describes what it is, how it was built, and where it is expected to fail. Reading one carefully takes about ten minutes and saves a great deal of time later, because most integration surprises are documented somewhere in it.

The sections below appear, under varying names, on most speech model releases. The order here is the order in which they tend to matter.

Intended use and out-of-scope use

This section is a boundary, not marketing. If a model is described as intended for research or for short-form generation, that is usually a statement about where it was tested rather than a legal restriction, and it predicts where quality degrades. A model documented for single-sentence generation will often drift in speaker identity across a long passage, because nothing during development pushed against that.

The licence tells you what you may ship. The training-data description tells you what will break.

Training data

The description of training material predicts almost every downstream limitation: which languages and accents are covered, which recording conditions the model expects, and how it will behave on text that looks nothing like its corpus. A model trained largely on read speech will sound like read speech even when asked for conversation.

Look for the sampling rate, the approximate hours, whether the audio is single-speaker or many, and whether transcripts were human-produced or generated by a recogniser. Recogniser transcripts push the model towards fluent, punctuation-poor delivery, because that is what the labels encoded.

Evaluation

Reported numbers matter less than the protocol behind them. For subjective scores, the useful details are how many listeners took part, whether they were screened, what they were asked, and what the comparison condition was. For objective measures, the useful detail is which reference the measure was computed against. A number with no protocol is a claim, not a measurement.

Licence and weights

Two separate things are licensed and they are often licensed differently: the code and the weights. Permissive code with restricted weights is a common arrangement and is easy to miss. The practical question to answer before building anything is whether the licence covers the specific output you intend to distribute, not merely whether it permits running the model.

Limitations and safety notes

For speech models this section usually covers voice cloning, and it is worth reading in full rather than skimming. It typically records whether any output marking is applied, what the maintainers expect of downstream users regarding consent for reference audio, and which misuse patterns they consider foreseeable. Those expectations are the practical starting point for a project's own policy.

If a card omits this section entirely, that omission is itself information about how much thought went into release.