# Comma (`comma-1`): Punctuation and capitalization

Fix lowercase, run-on text from speech and chat.

Comma puts punctuation and capital letters back into text that lost them: speech-to-text output, chat logs, subtitles, OCR. It adds periods, commas, question marks and colons, capitalizes sentence starts and names, and uppercases acronyms, in about 90 languages.

Pair it with Scribe for clean transcripts, or run it before any model that reads sentences.

- **Price:** $0.02 per 1,000 texts. One unit per text up to 2,000 characters; longer texts are split into 2,000-character chunks and each chunk is a unit.
- **Languages:** ~90 languages (not Thai, Lao, Khmer, Burmese or Tibetan)
- **Input:** A string, or an array of up to 64 strings to run as a batch.
- **Batch:** yes, up to 64 inputs per call
- **Status:** live
- **Built on:** [Horizon-Labs/multilingual-punctuation-truecase-small](https://huggingface.co/Horizon-Labs/multilingual-punctuation-truecase-small), Apache-2.0, 140M (mmBERT-small encoder)

## Request

```bash
curl https://labs.greatwork.company/v1/run \
  -H "Authorization: Bearer $GWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"comma-1","input":"ok so the plan for q3 is to ship the api first then the dashboard does anyone have concerns about the timeline sarah you mentioned the nasa contract"}'
```

## Options

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `input` | string or string[] | yes | | A string, or an array of up to 64 strings to run as a batch. |


## Output

| Field | Type | Description |
|---|---|---|
| `text` | string | The text with punctuation and casing restored. |
| `changes` | integer | How many words changed. |

The response envelope is always `{"id", "object": "run", "model", "created", "output", "usage": {"units", "unit", "cost_usd", "cost_micros"}, "latency_ms"}`. With an array input, `output` is an array in the same order.

## Examples (real outputs from our servers)

### Meeting transcript

```json
{
  "model": "comma-1",
  "input": "ok so the plan for q3 is to ship the api first then the dashboard does anyone have concerns about the timeline sarah you mentioned the nasa contract"
}
```

```json
{
  "text": "Ok, so the plan for Q3 is to ship the API first, then the dashboard. Does anyone have concerns about the timeline? Sarah: You mentioned the NASA contract.",
  "changes": 11
}
```

71 ms, $0.00002.

### German

```json
{
  "model": "comma-1",
  "input": "ich habe gestern mit herrn müller gesprochen er kommt am montag nach berlin"
}
```

```json
{
  "text": "Ich habe gestern mit Herrn Müller gesprochen. Er kommt am Montag nach Berlin.",
  "changes": 7
}
```

32 ms, $0.00002.

## Good for

- Clean up raw speech-to-text
- Fix chat transcripts before summarizing
- Make subtitles readable
- Restore casing in all-lowercase data

## Limits and caveats

- Doesn't add exclamation marks, semicolons, quotes or brackets.
- Mixed-case names come out wrong (Iphone, Mcdonald's).
- Existing casing is ignored: the output is the model's casing.
