OpenAI Setup Guide

This guide will help you configure your OpenAI API Key in Chatbox to use GPT 5.2, o3, and other models.

Getting an API Key

Step 1: Register an OpenAI Account

  1. Visit OpenAI Platform
  2. Click "Sign up" to create an account (phone verification may be required)
  3. Complete email verification

Step 2: Add Payment Method

  1. After logging in, go to the Billing page
  2. Click "Add payment method" to add a credit card
  3. We recommend setting usage limits to control spending

Step 3: Create an API Key

  1. Go to the API Keys page
  2. Click "Create new secret key"
  3. Name your key (e.g., "Chatbox")
  4. Copy the generated key (shown only once, save it securely)

Configure in Chatbox

Step 1: Open Settings

  1. Open the Chatbox app
  2. Click the "Settings" entry in the bottom left
  3. Select "AI Provider" or "Model Settings"
💡
On mobile, tap the menu icon (☰) in the top left to open the sidebar first, then tap "Settings".

Step 2: Add OpenAI

  1. Click "Add Provider"
  2. Select "OpenAI"
  3. Paste your key in the "API Key" field
  4. Keep API Host as default: https://api.openai.com

Step 3: Select a Model

After saving, you can choose from these models:

ModelFeaturesUse Cases
gpt-5.2Latest flagship, best for coding and agentic tasksDaily chat, writing, analysis
gpt-5-miniFast and cost-efficientSimple tasks, high volume
o3Deep reasoning modelMath, coding, complex logic

Pricing

OpenAI charges by Token, with different rates for each model:

ModelInput PriceOutput Price
gpt-5.2$1.75 / 1M tokens$14.00 / 1M tokens
gpt-5-mini$0.25 / 1M tokens$2.00 / 1M tokens
o3$1.00 / 1M tokens$4.00 / 1M tokens

Prices may change. Please check OpenAI's official pricing for current rates.

Common Issues

API Key Not Working

Possible causes:

  • Key expired or deleted
  • Insufficient account balance
  • Key permission settings issue

Solutions:

  1. Check if the key is valid in OpenAI dashboard
  2. Confirm account has available balance
  3. Generate a new key

"Insufficient Quota" Error

Solutions:

  1. Visit the Usage page to check usage
  2. Add credits on the Billing page

Network Connection Issues

Possible causes:

  • Network cannot access OpenAI API
  • Proxy configuration issues

Solutions:

  1. Confirm network can access api.openai.com
  2. Check system proxy settings
  3. Try configuring proxy in Chatbox settings

Slow Response

Optimization tips:

  • Use gpt-5-mini for faster responses
  • Reduce conversation context length
  • Check network latency

Usage Tips

  1. Set usage limits: Configure monthly spending limits in OpenAI dashboard to avoid unexpected high bills
  2. Choose appropriate models: Use cheaper models for simple tasks, premium models for complex tasks
  3. Monitor usage regularly: Check the Usage page to understand Token consumption
  4. Protect your key: Never share your API Key publicly