# AI Keys

## Sonoran Radio AI

Sonoran Radio integrates with OpenAI to add additional features and functionality. Each feature can be easily enabled or disabled and have separate AI keys for optimal billing transparency.

## Generating an Open AI Key

### 1. Login to the Open AI Platform

Navigate to [platform.openai.com](https://platform.openai.com/) and create an account.

At the top left, select `Create Project` for a new category of Sonoran Radio API keys.

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FFuXCC4nmJoe7E3DVJHKI%2Fimage.png?alt=media&#x26;token=f2f471ee-cbc9-42ee-9d84-e15ed7756063" alt=""><figcaption><p>OpenAI: Create Project</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FEOxxv0u0BsbTovazFKcQ%2Fimage.png?alt=media&#x26;token=68ded731-cff7-486b-9bfc-37ce50aa080d" alt=""><figcaption><p>OpenAI: Name Project</p></figcaption></figure></div>

### 2. Add Billing Information

OpenAI charges based on usage for each model. You will need to add payment information for AI usage.

Navigate to `Settings` > `Billing` > `Add payment details` to add a credit or debit card on file. Once added, you can manually add credits and set billing limits.

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FGqicPb3rXQuOEb3JjLJT%2Fimage.png?alt=media&#x26;token=346cb954-35ff-4030-ac46-7ec1f494c781" alt=""><figcaption><p>OpenAI: Payment Details</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2F61BTguDGXWPZLPrwykNG%2Fimage.png?alt=media&#x26;token=4d198c75-4afc-4028-9ce7-b9297ea59adc" alt=""><figcaption><p>OpenAI: Payment Limits</p></figcaption></figure></div>

### 3. Generate an API Key

With the new project selected, navigate to `API Keys` > `Create new secret key`

Give the new API key a name (we recommend a separate key for [each AI feature](#ai-options) for optimal billing transparency) and select your Sonoran Radio project.

You can also restrict each key's model access based on the [specific feature's requirements](#ai-options).

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FbE6cF4zg8Ivbd4qgd5UA%2Fimage.png?alt=media&#x26;token=c57a63a5-58e4-4d5d-aaf7-6ce8a4e5f3bd" alt="" width="375"><figcaption><p>OpenAI: Generate Key</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fzy6KNoggkGaX74TZjYWf%2Fimage.png?alt=media&#x26;token=ff7b2afe-efac-4ad0-9683-90123f86fa52" alt="" width="251"><figcaption><p>OpenAI: Generate Key</p></figcaption></figure></div>

### 4. Add your API Key to Sonoran Radio

In Sonoran Radio, navigate to `Customize` > `AI` > toggle on and paste in your new OpenAI API key for the specific feature.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FrtCA3nKwW5SbGnYymyCp%2Fimage.png?alt=media&#x26;token=e7112eb1-9b2d-4eca-bc5a-eb4ac7cc465a" alt=""><figcaption><p>Sonoran Radio: OpenAI API Keys</p></figcaption></figure>

## AI Options

### [Dispatch AI](https://docs.sonoransoftware.com/radio/tutorials/integrations/dispatch-ai)

Dispatch AI offers in-depth integration to manage Sonoran CAD unit statuses, lookups, call creation, emergency calls, and more.

#### Model Requirements (OpenAI)

* `gpt-realtime-mini`
* `gpt-5-nano`
* `gpt-4o-mini-transcribe`
* `gpt-4o-mini-tts`

### [Transmission Log STT](https://docs.sonoransoftware.com/radio/tutorials/usage/dispatch-panel/transmission-logs) (Speech-To-Text)

Transmission logs enable dispatchers to review and replay previous transmissions. With AI integration, these logs are enhanced with text transcripts, making it easier to search, reference, and analyze past communications efficiently.

#### Model Requirements (OpenAI):

`whisper-1`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonoransoftware.com/radio/tutorials/integrations/ai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.