TokOne 文档

English

简体中文

English

简体中文

Appearance

Cursor ​

Cursor is a VS Code–based AI-native editor that supports a custom OpenAI Base URL. Point the Base URL at TokOne and you can use gpt-5.5-series models in Chat / Composer.

Install ​

Download the installer for your platform from cursor.com and launch it. Skip this step if you already use Cursor.

Configure ​

  1. Open settings: Cmd + , (macOS) / Ctrl + , (Windows / Linux).
  2. Go to "Models" / "Cursor Settings → Models".
  3. Uncheck all official models (otherwise Cursor prefers the official ones).
  4. Set the OpenAI API Key: enter sk-xxx in the "OpenAI API Key" field.
  5. Expand "Override OpenAI Base URL", enter https://api.tokone.ai/v1, click "Save" and "Verify".
  6. "Add model" in the model list: add gpt-5.5 and gpt-5.4, then save.

A successful Verify

After clicking "Verify", a green checkmark means the connection works. If it spins forever, see FAQ.

Verify ​

In the Chat / Composer model dropdown, select gpt-5.5 (the custom model you just added) and send a message. A reply means it works. You can also check the "Usage" page in the TokOne console.

FAQ ​

Verify spins forever ​

90% of the time the Base URL is wrong:

  • Missing /v1: https://api.tokone.ai → Verify fails
  • Protocol written as http:// → SSL error
  • Trailing /: https://api.tokone.ai/v1/

There's exactly one correct form: https://api.tokone.ai/v1.

Added models don't show in the dropdown ​

Make sure you saved after "Add model" and the toggle to the left of the model is on. Restart Cursor if needed.

Tab autocomplete / Bug Finder don't work ​

This is a Cursor product limitation

Cursor's Tab autocomplete, Bug Finder, Background Agent, and other advanced features only work with the official Cursor account and can't be replaced by a custom Base URL. This is not a TokOne limitation.

What a custom Base URL does enable: Chat, Composer, Cmd-K, Inline Edit, and other core chat/editing features. If you rely heavily on Tab autocomplete, keep a Cursor official subscription (for Tab) and use TokOne for everyday chat and Composer tasks, switching as needed.

401 even though the key is correct ​

Don't copy leading/trailing spaces or newlines with the key. Cursor doesn't trim automatically.

Next steps ​