跳到主要内容
支持地域：上海

第三方模型

本文介绍如何在云开发中调用控制台上配置的第三方模型（如 DeepSeek、智谱、自建 OpenAI 兼容服务、第三方生图服务等）。

准备工作​

  1. 进入 云开发 AI 控制台 → 选择第三方模型。
  2. 点击「添加模型提供商」，填写 模型提供商标识、BaseURL、API Key 等信息。
  3. 保存后，在调用 SDK 时使用控制台填写的「模型提供商标识」作为入参。
提示

配置自定义模型的完整步骤请参考 接入大模型。

生文模型​

调用 createModel() 时，将参数替换为控制台上的「模型提供商标识」。下面以 my-deepseek 为例：

// 入参 'my-deepseek' 即控制台上配置的「模型提供商标识」
const model = ai.createModel("my-deepseek");

const res = await model.generateText({
  model: "deepseek-chat",                     // 实际的模型名
  messages: [
    { role: "user", content: "介绍一下李白" },
  ],
});

console.log(res.text);

流式调用使用 streamText()：

const model = ai.createModel("my-deepseek");

const res = await model.streamText({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "写一首七言绝句" }],
});

for await (const chunk of res.textStream) {
  console.log(chunk);
}

更多用法详见 Node SDK 调用。

生图模型​

调用 createImageModel() 时，将参数替换为控制台上的「模型提供商标识」。下面以 my-image-provider 为例：

const imageModel = ai.createImageModel("my-image-provider");

const res = await imageModel.generateImage({
  model: "your-model-name",                   // 实际的模型名
  prompt: "一只可爱的猫咪在草地上玩耍",
});

console.log(res.data[0].url);

自定义 API 子路径​

SDK 默认使用 OpenAI 兼容的图片生成路径 images/generations。如果第三方服务的图片生成接口路径不同，可通过 generateImageSubUrlConfig 显式指定：

const imageModel = ai.createImageModel("my-image-provider");

// 第一层 key 为「模型提供商标识」，第二层 key 为「模型名称」
imageModel.generateImageSubUrlConfig["my-image-provider"]["custom-model"] = "images/custom/generations";

const res = await imageModel.generateImage({
  model: "custom-model",
  prompt: "一只可爱的猫咪在草地上玩耍",
});

最终请求地址为：

https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/<模型提供商标识>/<子路径>

更多生图能力详见 Node SDK 调用。

相关文档​