LinkAI API 基础配置教程

1. 获取 LinkAI API Key

1. 注册并登录 api1.link-ai.cc
2. 进入控制台，点击左侧「令牌管理」
3. 点击「添加令牌」
4. 创建完成后，复制生成的 API Key

2. 常见问题

2.1 使用 LinkAI API 后，Codex 原来的对话历史如何继续使用

对话历史与 model_provider 名称匹配，按以下顺序处理：

1. 查看旧会话使用的 model_provider 名称
2. 将新配置中的 model_provider 和 [model_providers.xxx] 名称设置为与旧会话一致
3. 重启 Codex
4. 如果自动继承失败，检查 ~/.codex/sessions/年/月/日/ 下的会话文件中的 model_provider 字段
5. 仍无法继承时，可以把旧会话文件内容作为上下文提供给新会话

2.2 如何启用或关闭 Codex fast 模式

• Codex CLI：按照当前 Codex CLI 界面提示操作
• Codex App：是否支持 fast 模式，以当前安装版本实际界面为准

3. Cursor 配置 LinkAI API

1. 打开 Cursor 设置
2. 找到 OpenAI API 或自定义 API 设置
3. 填入 Base URL：https://api1.link-ai.cc/v1
4. 填入 LinkAI API Key
5. 点击添加模型，填写当前 API Key 支持的模型名称
6. 保存并测试

4. Codex 配置 LinkAI API

第一步：配置 config.toml

文件位置：

• macOS / Linux：~/.codex/config.toml
• Windows：%USERPROFILE%\.codex\config.toml

model_provider = "crs"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api1.link-ai.cc"
wire_api = "responses"

配置说明：

• model：使用的模型名称
• model_reasoning_effort：思考强度
• base_url：LinkAI API 地址
• wire_api = "responses"：使用 Responses 格式

模型是否可用，以 LinkAI 控制台为准。

第二步：配置 auth.json

文件位置：

• macOS / Linux：~/.codex/auth.json
• Windows：%USERPROFILE%\.codex\auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

说明：

• 替换为 LinkAI 控制台创建的真实 API Key
• Key 前后不要有空格
• 不要向他人公开

第三步：重启 Codex

配置两个文件后，完全退出并重新打开 Codex，使配置生效。

5. Claude Code 配置 LinkAI API

配置文件位置

• macOS / Linux：~/.claude/settings.json
• Windows：%USERPROFILE%\.claude\settings.json

settings.json 内容

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api1.link-ai.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  },
  "alwaysThinkingEnabled": true,
  "effortLevel": "medium"
}

配置说明：

• ANTHROPIC_BASE_URL：API 地址
• ANTHROPIC_AUTH_TOKEN：API Key
• ANTHROPIC_MODEL：模型名称
• effortLevel：思考强度（low / medium / high）

保存后重启 Claude Code。

6. VS Code 配置

6.1 Codex 官方插件

VS Code Codex 插件读取 Codex 的配置。按 Codex 章节配置好 config.toml 和 auth.json 后，重新打开 VS Code 即可。

model_provider = "crs"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api1.link-ai.cc"
wire_api = "responses"

6.2 Claude Code for VS Code 插件

插件没有独立的 LinkAI 配置入口。按 Claude Code 章节配置好 settings.json 后，重新打开 VS Code 并新建对话即可。

7. IntelliJ IDEA 配置

1. 打开「设置 → 外观与行为 → 系统设置 → 语言和区域」，如地区影响 AI Assistant，调整为美洲并重启 IDEA
2. 打开「设置 → 工具 → AI Assistant → 提供商与 API 密钥」
3. 提供商选择「兼容 OpenAI」
4. URL 填入 https://api1.link-ai.cc/v1
5. API 密钥填入 LinkAI API Key
6. 点击测试连接，确认配置正确
7. 选择模型并保存

8. OpenClaw 配置

运行交互式配置：

openclaw onboard

按以下顺序完成配置：

1. 选择 Yes
2. 选择 QuickStart
3. 选择 Custom Provider
4. 填写 Base URL：https://api1.link-ai.cc/v1
5. 选择 Paste API key now
6. 粘贴 LinkAI API Key
7. 选择 OpenAI-compatible
8. 填写当前账号支持的模型名称
9. 为配置起一个名称（无限制）
10. 最后一步按需留空或填写

保存后重新打开或重启 OpenClaw。

9. 图片接口 Curl 使用说明

调用图片生成接口，返回 Base64 数据并保存为本地文件：

完整示例

curl -X POST "https://api1.link-ai.cc/v1/images/generations" \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean product photo of a minimalist ceramic mug on a wooden desk",
    "output_format": "png"
  }' | jq -r '.data[0].b64_json' | base64 --decode > image.png

使用步骤

1. 将 sk-你的API密钥 替换为真实 Key
2. 按需修改 prompt 内容
3. 在终端执行命令
4. 打开生成的 image.png 查看结果

命令说明

该命令完成三件事：

1. 向图片生成接口发送 POST 请求
2. 从返回的 JSON 中提取 Base64 数据
3. 将 Base64 解码为二进制图片并保存为 image.png