快速开始

本页给第一次使用蛋蛋的用户准备。先确认两个概念：API Key 原样复制，不加后缀；Base URL 按客户端协议填写。

入口信息

场景	应填地址
控制台	`https://portdan.com/login`
OpenAI SDK / OpenAI Compatible 客户端	`https://portdan.com/v1`
Claude Code / Anthropic SDK 的 Base URL	`https://portdan.com`
Gemini CLI 的 Base URL	`https://portdan.com`
Gemini 原生 HTTP / OpenCode Gemini provider	`https://portdan.com/v1beta`
Antigravity Claude / Gemini CLI	`https://portdan.com/antigravity`
鉴权方式	`Authorization: Bearer <API_KEY>`

关键结论

控制台生成的 Key 不需要加后缀，也不应该加后缀。sk-xxx、自定义 Key 或其它前缀的 Key，都按控制台显示的完整原文使用。

1. 获取 API Key

进入控制台后，在令牌页面创建新的 API Key。选择分组时要按用途选择：OpenAI 兼容、Claude / Anthropic、Gemini 或 Antigravity 的可用模型由分组控制。

建议为不同客户端分别创建令牌，例如 chatbox-home、cursor-work、claude-code-main、server-prod，方便后续限额和排查。

2. 先测试 OpenAI 兼容模型列表

bash

curl https://portdan.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

能返回模型数组，说明域名、Key 和分组基础鉴权已通过。

3. 测试一次 OpenAI Chat Completions

bash

curl https://portdan.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "请只回复 OK"}
    ]
  }'

返回 choices[0].message.content，说明 OpenAI 兼容对话接口可用。模型名只是示例，真实模型名以控制台和 /models 返回为准。

4. 按客户端填写地址

客户端类型	Provider / 供应商	Base URL / Host	API Key
ChatBox、Cherry Studio、Cursor、Continue、Cline	OpenAI Compatible / Custom OpenAI	`https://portdan.com/v1`	原样复制
OpenAI SDK	OpenAI-compatible	`https://portdan.com/v1`	原样复制
Claude Code	Anthropic / Claude	`https://portdan.com`	原样复制到 `ANTHROPIC_AUTH_TOKEN`
Codex / CC Switch 导入	Codex / OpenAI	`https://portdan.com`	原样复制
Gemini CLI	Gemini	`https://portdan.com`	原样复制到 `GEMINI_API_KEY`
OpenCode Gemini provider	Gemini	`https://portdan.com/v1beta`	原样复制
Antigravity Claude / Gemini CLI	Antigravity	`https://portdan.com/antigravity`	原样复制

TIP

不要把 Base URL 写成 https://portdan.com/v1/chat/completions、https://portdan.com/v1/messages 这类完整接口地址。只有直接用 curl 调接口时才写完整路径。

下一步

写代码调用：看 API 说明。
接入图形客户端：看客户端接入。
接入 Claude Code、Codex、Gemini CLI：看 Claude Code / Codex / Gemini。
报错排查：看常见问题。

快速开始 ​

入口信息 ​

1. 获取 API Key ​

2. 先测试 OpenAI 兼容模型列表 ​

3. 测试一次 OpenAI Chat Completions ​

4. 按客户端填写地址 ​

下一步 ​