Documentation

Complete guides for installing, configuring, and using OpttiAI plugins.

Installation

Installing the Plugin

To install OpttiAI plugins, navigate to your WordPress admin dashboard, go to Plugins > Add New, and search for "OpttiAI". Click Install Now and then Activate.

System Requirements

OpttiAI plugins require WordPress 5.0 or higher, PHP 7.4 or higher, and at least 128MB of PHP memory. For optimal performance, we recommend PHP 8.0+ and 256MB of PHP memory.

Setup

Initial Configuration

After activation, go to Settings > OpttiAI to configure your API key. You can obtain your API key from your OpttiAI dashboard. Enter your key and save the settings.

Connecting Your Account

If you don't have an account, you can create one directly from the plugin settings page. Once connected, your API key will be automatically configured.

Token Usage

Understanding Token Usage

Each AI generation (alt text, meta description, etc.) consumes tokens from your monthly allocation. Token usage varies based on the complexity of the task. Simple alt text generation typically uses 1-2 tokens, while complex meta descriptions may use 3-5 tokens.

Monitoring Usage

You can monitor your token usage in the OpttiAI dashboard. The plugin also displays your remaining tokens in the WordPress admin panel. When you're running low, you'll receive notifications.

API Explanation

API Endpoints

OpttiAI plugins use RESTful API endpoints to communicate with our servers. All API calls are made over HTTPS using secure authentication. Your API key is encrypted and stored securely.

Rate Limiting

API requests are rate-limited based on your plan. Free plans have a limit of 10 requests per minute, Pro plans have 50 requests per minute, and Agency plans have 200 requests per minute.

Data Privacy

What Data is Sent

When generating alt text or meta descriptions, the plugin sends the following data to our servers: image file (for alt text), post content (for meta descriptions), and your site URL. This data is used solely for AI processing and is not stored permanently.

Data Retention

Processed data is temporarily stored for up to 24 hours for quality assurance and then permanently deleted. We do not use your content for training AI models or any other purpose.

Third-Party Services

OpttiAI uses OpenAI and other AI service providers to process your requests. These services are bound by strict data processing agreements and do not retain your data after processing.

Troubleshooting

Plugin Not Generating Alt Text

If the plugin is not generating alt text, check the following: 1) Verify your API key is correct, 2) Ensure you have remaining tokens, 3) Check that images are properly uploaded, 4) Review error logs in Settings > OpttiAI > Logs.

API Connection Errors

If you're experiencing API connection errors, verify your server can make outbound HTTPS requests. Some hosting providers block outbound connections. Contact your host or check the plugin logs for specific error messages.

Slow Generation Times

Generation times depend on image size and server response times. Large images may take longer to process. Consider optimizing images before upload or using the bulk processing feature during off-peak hours.