AI大模型使用教程-API接入与IDE配置-北京着陆云科技

概览

着陆云 AI 大模型服务以「一个 Key、OpenAI 兼容网关」方式接入多款主流模型，减少多平台切换与分散计费的成本。你先购买积分资源包，审核开通后即可在业务代码或 Cursor / VS Code 等 IDE 中调用。

聚合多模型：文本、图像、音视频等能力按模型广场当期开放范围为准
一套凭证：Base URL + API Key，兼容 OpenAI SDK / 多数 OpenAI Compatible 客户端
可控消耗：积分资源包（有效期 1 年）优先扣减；可另在 Key 上设日/月预算与访问限制（可选）

典型场景

企业服务

智能客服
企业知识库
长文档分析

电商 / 营销

智能运营
内容创作
互动直播辅助

创作与工具

文案与视频创意
社群运营助手
IDE 编程辅助

开通与获取凭证

着陆云侧由顾问审核交付密钥，无需自行在第三方控制台「创建 Key」。忘记凭证时，登录官网个人中心即可再次查看。

选购资源包
在大模型方案页选择体验 / 标准 / 专业 / 旗舰积分包（额度 + 有效期 1 年，≠ 按月额度），加入购物车或直接购买。
支付并等待审核
付款成功后订单进入「待审核」。此时不会显示真实 API Key，属正常状态。
在「我的大模型」查看
审核通过后，个人中心「我的大模型」会显示 Base URL、API Key，以及简要配置说明。

选购入口：大模型方案 · 凭证入口：我的大模型 · 下方提供 API 示例与 IDE 逐步配置。

配置速查

Base URL: https://**** 购买后请前往个人中心我的大模型查看
鉴权: Authorization: Bearer YOUR_API_KEY
常用路径: /chat/completions /models /response
示例模型: deepseek-ai/DeepSeek-R1

审核交付后，以我的大模型中显示的 Base URL / Key 为准；代码示例中的 YOUR_BASE_URL 请替换为交付地址。密钥形如 xn-…，勿写入前端或公开仓库。

开发示例

curl YOUR_BASE_URL/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-R1",
    "messages": [{"role": "user", "content": "你好"}]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="YOUR_BASE_URL/",
)
print(client.chat.completions.create(
    model="deepseek-ai/DeepSeek-R1",
    messages=[{"role": "user", "content": "你好"}],
).choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LLM_API_KEY,
  baseURL: "YOUR_BASE_URL",
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-R1",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'YOUR_BASE_URL/',
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Content-Type'  => 'application/json',
    ],
]);
$res = $client->post('chat/completions', [
    'json' => [
        'model' => 'deepseek-ai/DeepSeek-R1',
        'messages' => [['role' => 'user', 'content' => '你好']],
    ],
]);
echo json_decode((string) $res->getBody(), true)['choices'][0]['message']['content'];

OkHttpClient http = new OkHttpClient();
String body = "{\"model\":\"deepseek-ai/DeepSeek-R1\","
    + "\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}";
Request req = new Request.Builder()
    .url("YOUR_BASE_URL/chat/completions")
    .addHeader("Authorization", "Bearer YOUR_API_KEY")
    .addHeader("Content-Type", "application/json")
    .post(RequestBody.create(body, MediaType.get("application/json")))
    .build();
try (Response resp = http.newCall(req).execute()) {
    System.out.println(resp.body().string());
}

import (
    "context"
    "fmt"
    "log"
    openai "github.com/sashabaranov/go-openai"
)

cfg := openai.DefaultConfig("YOUR_API_KEY")
cfg.BaseURL = "YOUR_BASE_URL"
client := openai.NewClientWithConfig(cfg)
resp, err := client.CreateChatCompletion(context.Background(), openai.ChatCompletionRequest{
    Model: "deepseek-ai/DeepSeek-R1",
    Messages: []openai.ChatCompletionMessage{
        {Role: openai.ChatMessageRoleUser, Content: "你好"},
    },
})
if err != nil { log.Fatal(err) }
fmt.Println(resp.Choices[0].Message.Content)

安全与限额建议

密钥形如 xn-…，勿写入前端页面或公开仓库；若泄露后请联系顾问设置 IP 白名单。
可设置日 / 月预算上限（Key 可选消费上限，与年包独立；留空不限制），超额后停止该 Key 调用，避免短时间耗尽年包积分。
模型 ID 以 GET /models 或方案页模型列表为准，勿使用未授权模型名。

日常运维要点

模型列表

可用模型以着陆云大模型方案页与网关 /models 接口为准，可按提供商、类型筛选了解能力边界。

用量与账单

调用按 token / 秒 / 张 / 次等计费单元折算后，再乘以模型消耗系数扣减积分。详见计费说明页。

资源包优先

开通后优先消耗已购年有效期积分包；未产生调用则不扣减。日/月预算是 Key 上的可选节奏控制，不是把年包改成月包。额度不足时按控制台规则转后付费或停用。

凭证找回

登录着陆云官网 → 个人中心 → 我的大模型，即可再次查看已交付的 API Key 与 Base URL（默认脱敏，可一键显示/复制）。

积分公式与消耗系数见计费说明。

常见问题

支付成功为什么看不到 Key？

付款后需人工审核开通。状态为「待审核」时不会显示密钥；通过后会变为「正常」，并在「我的大模型」展示。

忘记 API Key 怎么办？

登录着陆云官网个人中心打开「我的大模型」，在对应资源包中显示并复制即可。勿向陌生人索要密钥。

401 或无权限？

检查 Key 是否已交付且启用、模型是否在允许列表、资源包/预算是否充足，以及 Base URL 是否与交付信息一致。

本教程和「计费说明」有什么区别？

本页覆盖开通流程、开发示例与 IDE 配置；计费说明解释积分消耗公式与模型系数对照。

IDE 配置

在支持「OpenAI Compatible」的工具中，核心只需填三项参数。下文按常用 IDE 给出可照做的详细步骤；展开对应条目即可。

Base URL — https://****，购买后请前往个人中心我的大模型查看
API Key — 交付后在我的大模型查看，形如 xn-…
Model — 如 deepseek-ai/DeepSeek-R1（以网关 /models 或方案页为准）

Cursor AI IDE

内置自定义 OpenAI 兼容接口，适合日常编码与 Agent。

打开 Cursor → Settings（macOS：Cmd + ,；Windows：Ctrl + ,）。
进入 Models（或 Models / API Keys）页面。
开启 OpenAI API Compatible / 自定义 OpenAI 兼容接口（文案因版本略有差异）。
填写 Base URL：YOUR_BASE_URL。
填写 API Key：在「我的大模型」复制的 xn-… 密钥。
在模型列表中添加或选用模型 ID，例如 deepseek-ai/DeepSeek-R1；确认该模型在聊天 / Composer / Agent 中可选。
新开 Chat 或 Composer，选中刚配置的模型，发送一句「你好」做连通性验证。

注意

若填了官方 OpenAI Key 同时又开了兼容接口，确认当前会话选的是自定义模型，而不是默认 OpenAI 模型。
Override OpenAI Base URL 类开关未打开时，密钥不会走到着陆云网关。

Trae AI IDE

国内常用 AI IDE；在自定义模型 / OpenAI Compatible 中接入。

打开 Trae → 进入 设置 / Settings（齿轮或账号菜单内）。
找到模型、AI 服务 或 自定义模型 相关入口。
新增模型时，API 类型 / Provider 选择 OpenAI 或 OpenAI Compatible。
Base URL / API Base 填 YOUR_BASE_URL（勿填 api.openai.com）。
API Key 填 xn-…；Model 填 deepseek-ai/DeepSeek-R1（或你在模型列表中确认过的 ID）。
保存后，在对话 / 补全面板切换到该自定义模型并试发一条消息。

注意

部分版本把「兼容模式」与「官方模型」分栏；务必在自定义/兼容栏填写着陆云参数。
若仅填 Key 未改 Base URL，请求仍会打到默认厂商地址导致失败。

VS Code 编辑器

通过 Continue、Cline、Roo Code 等插件配置 openai provider。

安装扩展：在扩展市场搜索并安装 Continue 或 Cline（任选其一即可；也可按团队规范选用 Roo Code 等同类插件）。
打开插件配置：Continue 一般通过侧栏 Continue → 齿轮 / ~/.continue/config.json；Cline 在设置中搜索 Cline 或打开其面板的 API 配置。
Provider / API Provider 选择 openai（或 OpenAI Compatible）。
配置字段对照：apiBase / Base URL = YOUR_BASE_URL；apiKey = xn-…；model = deepseek-ai/DeepSeek-R1。
Continue 示例片段（按需合并进配置，勿提交真实密钥）："provider": "openai", "apiBase": "YOUR_BASE_URL", "model": "deepseek-ai/DeepSeek-R1"，密钥走环境变量或插件密钥栏。
保存后重载窗口（Command Palette → Developer: Reload Window），在聊天面板选中该模型试连。

注意

字段名因插件而异：可能是 apiBase、baseUrl、openaiBaseUrl，含义相同，都填到 /v1。
不要同时把系统代理指到错误网关；公司代理若改写 HTTPS，需放行着陆云域名。

PhpStorm JetBrains

JetBrains 家族详细示例：AI Assistant 或第三方 LLM 插件均可。

打开 PhpStorm → Settings / Preferences（macOS：Cmd + ,；Windows/Linux：Ctrl + Alt + S）。
若使用内置 AI Assistant：进入 Tools → AI Assistant（或 AI Chat）相关节点，查看是否支持自定义 / 第三方 LLM、OpenAI Compatible 提供商。
若内置项无法自定义网关：打开 Plugins，安装支持 OpenAI Compatible 的第三方插件（常见如 ProxyAI、Continue 对应集成、或其他「Custom OpenAI」类插件），安装后重启 IDE。
在插件或 AI Assistant 的 Provider 列表中选择 OpenAI Compatible / Custom OpenAI。
填写 Base URL：YOUR_BASE_URL。
填写 API Key（或 Token / Secret）：xn-…。
填写或添加 Model：deepseek-ai/DeepSeek-R1；若有「Fetch models」按钮可先拉列表再勾选。
可选：在 HTTP Proxy（Appearance & Behavior → System Settings → HTTP Proxy）确认不会把该域名错误代理到内网。
打开 AI Chat 工具窗口，选择刚添加的模型，发送测试消息；成功即表示网关与密钥可用。

注意

JetBrains 部分版本 AI Assistant 仅支持官方账号登录；此时请改用支持自定义 Base URL 的插件，不要强行填 OpenAI 官方地址。
「Test Connection」失败时先核对 Key 是否已在「我的大模型」交付为「正常」状态。
Model 必须与网关 ID 完全一致，含供应商前缀（如 deepseek-ai/…）。

IntelliJ IDEA JetBrains

与 PhpStorm 同一套 Settings 路径，适用于 Java / Kotlin 后端。

Settings（Ctrl + Alt + S / Cmd + ,）→ Tools → AI Assistant，或 Plugins 中安装 OpenAI Compatible 插件。
Provider 选 OpenAI Compatible。
Base URL：YOUR_BASE_URL；API Key：xn-…；Model：deepseek-ai/DeepSeek-R1。
Apply → 打开 AI Chat，切换到该模型并测试。
若使用 Continue 等跨 IDE 插件：在其配置里同样填 openai + 上述三项，与 VS Code 侧配置可共用一份（注意路径差异）。

注意

Community 与 Ultimate 对 AI Assistant 开放程度不同；无内置自定义时一律走第三方 Compatible 插件。
避免在「OpenAI」官方 Provider 里只改 Key 不改 Base URL。

WebStorm JetBrains

前端 / Node 项目常用；配置路径与 PhpStorm 一致。

Settings → Tools → AI Assistant，或安装支持 OpenAI Compatible 的插件。
选择 OpenAI Compatible，填入 Base URL YOUR_BASE_URL、API Key xn-…、Model deepseek-ai/DeepSeek-R1。
在 AI Chat / Inline 补全中选用该模型；前端项目可同时在终端用同一 Key 跑 Node SDK（见本页开发示例）。
Apply 后新开 Chat 验证。

注意

若同时开了 GitHub Copilot 等其他助手，注意当前补全来源，避免误以为着陆云未生效。
Base URL 不要写成带 /chat/completions 的完整路径。

PyCharm JetBrains

Python 数据 / 后端开发；IDE 内配置 + 本地 SDK 可并行。

Settings → AI Assistant 或第三方 OpenAI Compatible 插件。
填 Base URL YOUR_BASE_URL、Key xn-…、Model deepseek-ai/DeepSeek-R1。
测试 Chat 连通后，若需在项目代码中调用：使用官方 openai Python 包，将 base_url 设为同一地址（参见开发示例）。
建议用环境变量（如 LLM_API_KEY）存放密钥，勿写进仓库。

注意

Notebook 与 IDE Chat 是两套入口；Notebook 里需自行写客户端代码或装对应魔法命令扩展。
虚拟环境与系统 Python 无关；密钥配置在 IDE AI 设置中，不随 venv 切换丢失。

GoLand JetBrains

Go 后端常用；JetBrains 配置方式同上。

Settings → Tools → AI Assistant，或 Plugins 安装 OpenAI Compatible 插件。
Provider：OpenAI Compatible；Base URL：YOUR_BASE_URL；API Key：xn-…；Model：deepseek-ai/DeepSeek-R1。
Apply 后在 AI Chat 中测试；业务代码可用 Go OpenAI 客户端库指向同一 Base URL。

注意

部分插件默认模型名为 gpt-4o 等，需改成网关真实 ID，否则会 404 / 无权限。
公司 Go module proxy 与 LLM 网关无关；连通失败优先查 Key 与 Base URL。

Android Studio 移动端

基于 IntelliJ 平台；用 AI Assistant 或 Compatible 插件接入。

打开 Android Studio → Settings（Windows/Linux：Ctrl + Alt + S；macOS：Cmd + ,）。
查看 Tools → AI / Gemini / AI Assistant 节点：若仅支持 Google 账号且无法改 Base URL，改为安装 OpenAI Compatible 第三方插件。
在插件中选择 OpenAI Compatible，填写 Base URL YOUR_BASE_URL、API Key xn-…、Model deepseek-ai/DeepSeek-R1。
重启 IDE（若插件要求）→ 打开对应 AI 工具窗口 → 选模型 → 测试对话。
编写 App 内网络请求时：移动端切勿把 API Key 打进 APK；仅用于本机 IDE 辅助或经自有后端转发。

注意

Studio 内置 Gemini 与着陆云网关不是同一套；不要把 xn- Key 填进 Google AI 登录框。
模拟器/真机调试业务接口时，应走你们自己的服务端，而不是直连大模型 Key。

DevEco Studio 鸿蒙

鸿蒙应用开发 IDE（IntelliJ 系）；第三方 Compatible 插件接入。

打开 DevEco Studio → Settings / Preferences。
优先在 Plugins 中安装支持 OpenAI Compatible 的 AI 插件（与 Android Studio / IDEA 同类）。
配置 Base URL YOUR_BASE_URL、API Key xn-…、Model deepseek-ai/DeepSeek-R1。
在 AI 对话窗口选择该模型并验证。
HarmonyOS 工程内的云侧调用同样建议经自有服务转发，避免 Key 进客户端包。

注意

DevEco 版本迭代快，菜单名可能是「AI Assistant」「CodeGenie」等；以能填写自定义 Base URL 的入口为准。
勿将 Base URL 设为华为云或其他厂商默认地址后再塞入着陆云 Key。

HBuilderX uni-app

uni-app 常用；通过内置 AI 或插件配置 OpenAI 兼容接口。

打开 HBuilderX → 工具 / 设置（或 插件安装）。
若版本提供 AI 大模型 / 代码助手 设置：打开后选择自定义 / OpenAI 兼容。
若无内置项：在插件市场安装支持自定义 API 的 AI 插件，按插件说明打开配置页。
填写接口地址 YOUR_BASE_URL、密钥 xn-…、模型 deepseek-ai/DeepSeek-R1。
保存后在 AI 面板提问验证；uni-app 业务侧调用请走云函数或自有后端，勿把 Key 写进前端 manifest。

注意

部分模板默认请求地址含 api.openai.com，必须整项替换为着陆云 Base URL。
HBuilderX 内置终端跑 Node 脚本时，环境变量与 IDE AI 设置相互独立，需分别配置。

微信开发者工具小程序

小程序开发；IDE 内 AI 助手或本地代理客户端使用兼容接口。

打开微信开发者工具，确认已登录并打开目标小程序项目。
若当前版本提供 AI 助手 / 智能补全 且支持自定义模型：在其设置中选择 OpenAI / 兼容模式。
填入 Base URL YOUR_BASE_URL、API Key xn-…、Model deepseek-ai/DeepSeek-R1。
若工具内无法改网关：可在本机用 Cursor / VS Code Continue 编辑同一项目目录，或使用支持 OpenAI Compatible 的桌面客户端作辅助；小程序运行时的模型请求必须经你们的服务端转发。
在微信公众平台 / 云开发中配置服务器域名时，只放行你们业务 API 域名，不要把 API Key 下发到小程序前端。

注意

小程序 request 合法域名校验与 IDE 辅助配置是两回事；前端直连大模型网关既不安全也常被域名拦截。
不要把 xn-… 写进 app.js 或代码仓库。

Xcode iOS

无系统级 OpenAI Compatible 开关；配合第三方插件或外部客户端。

Xcode 本身通常不提供可填 Base URL 的官方大模型设置。推荐两种用法：① 用 Cursor / Trae / VS Code 打开同一工程目录做 AI 辅助；② 安装支持自定义 OpenAI 接口的 Xcode 源代码编辑扩展 / 助手类工具（随 App Store 或开源社区版本变化，安装后找 Settings → API）。
在第三方工具中选择 API 类型 OpenAI / OpenAI Compatible。
Base URL 填 YOUR_BASE_URL，API Key 填 xn-…，Model 填 deepseek-ai/DeepSeek-R1。
也可使用 macOS 上支持自定义 Endpoint 的 Chat 客户端，将工程问题粘贴对话；密钥仅保存在本地钥匙串或客户端保险箱。
App 真机/上架包内禁止嵌入 API Key；生产流量经自有后端调用网关。

注意

勿将着陆云 Key 填入仅支持 Apple Intelligence / 官方账号且不能改 Base URL 的入口。
Swift 示例若复制自 OpenAI 官方，请把 baseURL 改为 YOUR_BASE_URL，并确认未误用 api.openai.com。

通用易错点

Base URL 必须使用着陆云交付地址（购买后在我的大模型查看），不要填 https://api.openai.com 或其 /v1。
多数客户端 Base URL 填到 /v1 即可；不要再拼 /chat/completions。若工具自动再追加 /v1，出现 /v1/v1 时去掉末尾一层。
尾部斜杠：有的插件要求 …/v1，有的要求 …/v1/。报 404 时先切换有无斜杠再试。
Model 填网关返回的完整模型 ID（如 deepseek-ai/DeepSeek-R1），不要只填展示名「DeepSeek R1」。以 GET /models 或方案页列表为准。
API Key 形如 xn-…，在登录后「我的大模型」查看；勿写入前端仓库或截图外传。

代码调用示例见本页开发示例；计费见计费说明。

选购资源包打开我的大模型联系顾问