> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.thymia.ai/helios/llms.txt.
> For full documentation content, see https://docs.thymia.ai/helios/llms-full.txt.

# Error Reference

When a Helios model run completes with status `COMPLETE_ERROR`, the
response includes two fields to help diagnose the issue:

| Field         | Description                                                                                            |
| ------------- | ------------------------------------------------------------------------------------------------------ |
| `errorCode`   | A machine-readable code identifying the category of error. Use this to handle errors programmatically. |
| `errorReason` | A human-readable description of the error. Intended for debugging, not for display to end users.       |

```json
{
  "id": "ddebd75b-99b3-42b4-ac65-5ce852c688e9",
  "status": "COMPLETE_ERROR",
  "errorCode": "ERR_RECORDING_TOO_SHORT",
  "errorReason": "Recording supplied is too short. Please supply a recording containing at least 10 seconds of speech and that is under 3 minutes in length.",
  "userLabel": "operator-1234"
}
```

## Error codes

### ERR\_RECORDING\_INVALID\_FORMAT

The recording supplied was not in a supported file format.

**Supported formats:** FLAC, MP3, MP4, Ogg, WebM, WAV

**Recommended action:** Verify the file format and convert if
necessary before submitting a new model run.

***

### ERR\_RECORDING\_TOO\_SHORT

The recording supplied contained less than the minimum required amount
of speech.

**Minimum speech duration:** 10 seconds

**Recommended action:** Ask the user to speak for longer and submit
a new model run.

***

### ERR\_RECORDING\_TOO\_LONG

The recording supplied exceeded the maximum allowed length.

**Maximum recording length:** 3 minutes

**Recommended action:** Trim the recording to under 3 minutes and
submit a new model run.

***

### ERR\_TRANSCRIPTION\_FAILED

No speech was detected in the recording supplied.

**Recommended action:** Check audio quality and ask the user to
check their microphone before resubmitting.

***

### ERR\_INTERNAL

An internal error occurred during model processing.

**Recommended action:** Retry the model run. If the error persists,
contact [support@thymia.ai](mailto:support@thymia.ai) with the model
run ID.

***

## Warnings

```json
{
  "status": "COMPLETE_OK",
  "warnings": [
    "Audio quality may affect result accuracy."
  ],
  "results": { ... }
}
```

<Note>
  Results returned alongside warnings should be treated with caution.
  Consider flagging these to your users or discarding them depending
  on your use case.
</Note>

## HTTP errors

| Status code | Meaning              | Common cause                                         |
| ----------- | -------------------- | ---------------------------------------------------- |
| `401`       | Unauthorized         | Missing or invalid API key                           |
| `404`       | Not found            | Model run ID does not exist or data has been deleted |
| `422`       | Unprocessable entity | Request body is malformed or missing required fields |

<Note>
  A `404` response when retrieving results may indicate that data
  deletion was enabled for the model run and the 12-hour retention
  window has passed.
</Note>

## Next steps

* [Integration Guide](/helios/integration-guide) — Build a
  complete production integration including error handling.
* [Interpreting Results](/helios/interpreting-results) —
  Understand what `COMPLETE_OK` results mean and how to use them.
* [API Reference](/api-reference) — Complete endpoint
  documentation for the Helios API.

<div>
  ***
</div>

<div>
  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/bc677a592c05a522bf7c895b7e9f00da344a3487d5e6baf5e35f4b013bf0e0e5/docs/assets/certs/crown-commerical-logo.png" alt="Crown Commercial Service" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/0fd8cd1c5e2bf5fe9c88a9671b5d62d76ee00fff93b057d3f28295f6e74a8e54/docs/assets/certs/nhs-digital-toolkit-logo.png" alt="NHS Digital" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/3408b37c11afb0482b6108012fdea2edc6843ffa1a6a485d9440f2c28067165c/docs/assets/certs/iso-27001-logo.png" alt="ISO 27001" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/f82c2989ef0c7907f8acc1bf38c1debfb8061a0bad0fd4aff7a724794739e5b0/docs/assets/certs/iso-13485-logo.png" alt="ISO 13485" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/44816901d032fd0dc4b99030c62e6841d10b1796fde6dd1615bf23eb84f9114b/docs/assets/certs/HIPPA-logo.png" alt="HIPAA" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/1c6800dfced2f3bd97bd907302e2ae105c99ed91fd381e0cd64eef7886394779/docs/assets/certs/gdpr-logo.png" alt="GDPR" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/2276326b82aee8a143219440498266a25a1425c423a6854489e706af50d38118/docs/assets/certs/cyber-essentials-logo.png" alt="Cyber Essentials Certified" />
</div>