OpenAI API Platform Setup
How to create the correct OpenAI account, generate an API key, configure billing, and enable realtime model access for Voice Nexus Service.
This must be an OpenAI API Platform account
Do not assume a regular ChatGPT subscription is enough. You must sign up at https://platform.openai.com. A ChatGPT web subscription does not provide the API project, API key, billing setup, or model access configuration required for gpt-realtime in VNS.
Overview
To use gpt-realtime with Voice Nexus Service, you need four things:
API Platform Account
A valid OpenAI API Platform account — not just ChatGPT login access.
Project + API Key
A project with an API key created with All permissions and stored safely.
Billing
Available credits or a payment method enabled on the account.
Realtime Model Access
The project's limits must allow models that include the word realtime.
Create the OpenAI API Platform Account
- 1. Go to
https://platform.openai.com - 2. Click Sign Up
- 3. Create the account using an email address and password
- 4. Open the verification email from OpenAI
- 5. Enter the verification code to continue
Create the Organization and Project
- 1. During setup, OpenAI will prompt for an Organization
- 2. Optionally invite team members (can be skipped initially)
- 3. Create a Project Name
VoiceNexus
VNS-Production
VNS-Test
Create the API Key
- 1. Open the selected project
- 2. Navigate to API Keys
- 3. Click Create API Key
- 4. When prompted for Permissions, select All
- 5. Copy the key immediately and store it securely
CallStart response as the openAIToken value.
Add Billing / Credits
- 1. Open the project's Billing area
- 2. Add funds or enable the account's payment method
- 3. Note: new accounts often start with a low funding limit (e.g., $20)
Enable Realtime Models in Project Limits
- 1. Click the Project Name at the top of the screen
- 2. Select Manage Projects
- 3. Click the correct project in the list
- 4. In the left menu, click Limits
- 5. Under Model Usage, click Edit
- 6. Enable all models whose names include the word
realtime - 7. Click Save
gpt-realtime
gpt-realtime-mini
and any newer realtime model variants that appear in the project.
Set the Project Budget
- 1. Stay on the Limits screen
- 2. Click Edit Budget
- 3. Enter a monthly budget appropriate for expected usage
- 4. Click Save
Use the API Key in VNS
Once the API Platform account is working, place the API key into your VNS CallStart response as the openAIToken value:
{
"VoiceElements_Instructions": {
"openAIUrl": "wss://api.openai.com/v1/realtime?model=gpt-realtime",
"openAIToken": "sk-YOUR_OPENAI_API_KEY",
...
}
}
- The key was created from the correct project
- The project has available funds or billing enabled
- Realtime models are enabled in Limits
- The exact key value was copied correctly into your VNS configuration
Troubleshooting
If the API key does not work, review the error returned in your VNS logs, especially information captured at or near CallEnd.
| Error Type | Likely Cause | Suggested Fix |
|---|---|---|
| 401 Unauthorized | Invalid, incomplete, or revoked API key | Regenerate the key and update your VNS configuration |
| 403 Forbidden | Model access not enabled for the project | Go to Limits and enable all realtime models |
| 429 / Rate Limit | Insufficient funded balance or low usage tier | Add funds and continue using the account until higher limits become available |
| Billing Error | No credits or payment setup problem | Verify billing, available balance, and project budget settings |
Quick Checklist
Before your first test call, confirm every item below.
- Customer created an OpenAI API Platform account at platform.openai.com
- Did not rely only on a ChatGPT subscription
- Organization and project were created
- API key was generated with Permissions: All and stored safely
- Billing or credits were added
- Realtime models were enabled in Limits
- Monthly budget was configured
- API key was inserted into the VNS CallStart response as
openAIToken - Test call was placed successfully