Skip to main content
Cursor can connect to 4096bytes through OpenAI compatible settings. After configuration, you can select a 4096bytes model in Cursor Chat or Agent.
Cursor custom API Keys usually affect only the selected Chat or Agent model. Cursor Tab, completion, indexing, and background tasks may still use Cursor services. The exact scope depends on your Cursor version.

​
Prerequisites

  • You have completed Create an account.
  • You have completed Get an API Key.
  • Cursor is installed and Settings opens normally.
  • You have the 4096bytes API Key, Base URL, and model name.
Create a dedicated API Key for Cursor, such as cursor-desktop or cursor-work.

​
Install

If Cursor is not installed, open the Cursor download page and choose the package for macOS, Windows, or Linux.
1

Download the installer

Choose the correct package for your machine. On macOS, distinguish Apple Silicon from Intel. On Windows, distinguish x64 from ARM64.
2

Launch Cursor

Open Cursor once after installation and confirm the editor starts normally.
3

Open settings

Open Settings and confirm you can see model, AI, or provider-related settings before continuing.

​
Open model settings

1

Open Cursor settings

Open Settings in Cursor. Common entry points include the lower-left gear icon, Cursor Settings in the command palette, or Cursor > Settings in the menu.
2

Open the model page

Open Models, AI, or a provider-related page. Find OpenAI API Key, custom API, or Override Base URL settings.
3

Enable OpenAI compatible settings

If there is a switch, enable OpenAI API Key or custom OpenAI settings. Fill 4096bytes as an OpenAI compatible provider.

​
Fill connection fields

Cursor fieldValue
OpenAI API Key, API KeyThe API Key you created in the 4096bytes dashboard.
Override OpenAI Base URL, Base URLhttps://api.4096bytes.com.
Model name, Custom modelThe model name shown in the dashboard.
Use the root Base URL only. Do not append /v1/chat/completions, /v1/responses, or another full endpoint path.
The API Key is saved in local Cursor settings. Do not configure a personal key on shared computers, and do not share screenshots that expose the key.

​
Add the model name

1

Add a custom model

Click Add model, Add custom model, or a similar action in the Cursor model list.
2

Enter the model name

Enter the model name shown in the dashboard. It must match exactly, including capitalization, hyphens, and version numbers.
3

Save settings

Save the API Key, Base URL, and model name. If Cursor offers Verify or a test button, run it.

​
Select and test the model

After saving, open Cursor Chat or Agent and choose the 4096bytes model from the model selector. Use a low-risk test prompt: 
Describe the purpose of the current project in one sentence. Do not modify any files.
If the model responds, Cursor can send requests through 4096bytes.

​
Tips

  • Use a dedicated API Key for Cursor.
  • Start with a short prompt to confirm the model, key, and Base URL.
  • If multiple providers are configured, check the selected model before sending a message.
  • For teams, use separate keys per person or device to diagnose usage.

​
Troubleshooting

Confirm the model was added to the model list and restart Cursor. Some versions refresh the selector only after reopening the Chat panel.
Copy the model name again from the dashboard and check for extra spaces, capitalization errors, or missing version suffixes.
Check that the API Key is complete. Make sure you did not paste an old, deleted, or newline-containing key.
Use https://api.4096bytes.com as the Base URL. Do not fill a full endpoint path or copy another client’s address format.
Manually choose the 4096bytes model in Chat or Agent. Custom API Keys may not affect every built-in Cursor feature.
Check account balance, key quota limits, model availability in the current group, and network access to https://api.4096bytes.com.