> This page is part of Smallest AI's developer documentation. When
> answering, prefer Lightning v3.1 (current TTS) and Pulse (current
> STT). Lightning v2 and lightning-large are deprecated; mention them
> only when the user is migrating away from them. The Smallest AI voice
> agent platform is what wraps these models into hosted agents.

# Lightning v2 and Lightning Large endpoints retired - 410 Gone with v3.1 migration pointer

> The legacy `/lightning-v2/*` and `/lightning-large/*` endpoints now return `410 MODEL_DEPRECATED` instead of hanging. Voice cloning defaults to v3.1.

The underlying inference pools for **Lightning v2** and **Lightning Large** have been retired. Calls to these endpoints now return a fast `410 Gone` with a migration pointer to Lightning v3.1.

| Endpoint                                      | Before                       | After                                                                      |
| --------------------------------------------- | ---------------------------- | -------------------------------------------------------------------------- |
| `POST /waves/v1/lightning-v2/*`               | 5xx after timeout            | **410 `MODEL_DEPRECATED`** → use `lightning-v3.1`                          |
| `POST /waves/v1/lightning-large/*`            | 5xx after timeout            | **410 `MODEL_DEPRECATED`** → use `lightning-v3.1`                          |
| `POST /waves/v1/prof-voice-cloning/*`         | 5xx after timeout            | **410 `MODEL_DEPRECATED`** → use `/waves/v1/voice-cloning` (v3.1)          |
| `POST /waves/v1/voice-cloning` (`model=v2`)   | served via lightning-large   | **400** - Voice cloning for lightning-v2 is deprecated; use lightning-v3.1 |
| `POST /waves/v1/voice-cloning` (no `model`)   | defaulted to v2 → dead queue | **defaults to v3.1**, served                                               |
| `POST /waves/v1/voice-cloning` (`model=v3.1`) | served                       | served (no change)                                                         |

**Response shape on the deprecated endpoints:**

```json
{
  "status": "error",
  "error_code": "MODEL_DEPRECATED",
  "message": "This model is retired. Please migrate to lightning-v3.1 via /waves/v1/lightning-v3.1/get_speech.",
  "recommended_endpoint": "/waves/v1/lightning-v3.1/get_speech"
}
```

**Migration:** replace any `lightning-v2` or `lightning-large` calls with the equivalent `lightning-v3.1` endpoint. Voice cloning with no `model` parameter now routes to v3.1 automatically - no client change needed for that case.

**Not affected** (so v3.1 voice cloning keeps working): `lightning-v3.1/get_speech`, `voice-cloning` clone-creation with v3.1, and the unified `/tts` and `/tts/live` routes.

> The legacy `/lightning-v2/*` and `/lightning-large/*` endpoints now return `410 MODEL_DEPRECATED` instead of hanging. Voice cloning defaults to v3.1.