Use PotatoAI.cc in Cursor
Add an OpenAI-compatible service in Cursor model settings, then point the Base URL, API key, and model name to PotatoAI.cc.
Configuration Goal
Keep your Cursor account signed in, add PotatoAI.cc as a custom OpenAI-compatible provider, and test it with a short Chat or Agent request.
Preparation
| Field | Value |
|---|---|
| Provider | OpenAI Compatible |
| Base URL | https://www.potatoai.cc/v1 |
| API Key | The API key created in the PotatoAI.cc console |
| Model | The complete model ID shown in the console |
Configuration Steps
1. Open Model Settings
Open Cursor Settings, then find the Models, API Keys, or custom model provider area. Menu names may vary slightly between Cursor versions.
2. Add a Compatible Service
Choose OpenAI Compatible. If your Cursor version only exposes OpenAI settings, use the entry that allows you to override the Base URL.
3. Fill In the Endpoint and Key
Set the Base URL to https://www.potatoai.cc/v1, then paste the API key created in the PotatoAI.cc console.
4. Add the Model
Copy the complete model ID from the console. Do not remove version numbers, hyphens, capitalization, or other symbols.
Model ID Must Match
Cursor will fail to call the model if the ID does not exactly match the model shown in the PotatoAI.cc console.
5. Enable and Test
Save and enable the model, then send a short request in Chat or Agent to confirm that the model returns normally.
Accounts, Built-In Models, and Switching
| Topic | Note |
|---|---|
| Cursor account | You do not need to sign out. Cursor login handles editor sync and built-in Cursor features; the PotatoAI.cc API key only handles the configured model requests. |
| Built-in features | Not every Cursor feature goes through PotatoAI.cc. Features such as Tab Completion may still use Cursor's built-in services. |
| Switching back | If global Override OpenAI Base URL is enabled, turn it off before using official Cursor/OpenAI models. Enable it again when switching back to PotatoAI.cc. |
| Free plan limits | Cursor may limit custom API keys, Agent, or Edit features based on your current plan. Follow the Cursor client prompt. |
FAQ
| Symptom | Fix |
|---|---|
| No Verify button | Some newer versions take effect after saving. Select the added model, send a short message, and check PotatoAI.cc usage logs. |
model not found | Copy the full model ID again from the console and confirm the current account group has permission for that model. |
| Official models also fail | Turn off Override OpenAI Base URL and retry. In some versions, this setting affects other OpenAI models. |
| Network error / TLS error | Confirm the address is https://www.potatoai.cc/v1, then set HTTP Compatibility Mode to HTTP/1.1 in Network settings and test again. |
| Tab still does not use PotatoAI.cc | This is Cursor product behavior. Custom API keys mainly apply to supported chat models; Tab Completion may continue using built-in models. |
Recommendation
Dedicated Key
Create a separate API key for Cursor. This makes it easier to review usage by client, rotate the key, or disable Cursor access independently.
