📚 离职知识库

云雾 API 配置（yunwu.ai 聚合中转，文本大模型）

可迁移配置（2026-07-18）。 云雾是聚合中转站，一把 key 通 400+ 模型（DeepSeek / GPT / Claude / Gemini / Qwen / GLM / Grok…）。 任何新项目要接 AI 文字生成，照抄下面的环境变量 + 调用方式即可，换模型只改 LLM_MODEL 一个值。 生图用的是同一个 yunwu 账号但另一把 key，见《GPT-Image-2生图改图》。

#环境变量（OpenAI 兼容接口）

LLM_PROVIDER=yunwu                 # yunwu（默认）/ deepseek（官方直连备用）
YUNWU_API_KEY=<KEY>                # ⚠️ 一个项目一把 key，别共用，出问题能定位到站、额度能单独控
YUNWU_API_BASE=https://yunwu.ai/v1
LLM_MODEL=deepseek-v4-flash        # 默认模型，便宜快、结构化稳定；换模型只改这一行

#Key 管理经验

  • 一个项目一把 key（不要全线共用同一把）：出问题能定位到具体站点，额度也能单独控制。
  • 各项目 key 在云雾后台「令牌管理」里按项目命名建立，分别配到各自的部署环境变量中。
  • 生图用另一把独立 key（IMAGE_API_KEY），见《GPT-Image-2生图改图》。

#调用方式（POST ${YUNWU_API_BASE}/chat/completions，标准 OpenAI 协议）

#Node.js（openai SDK）

import OpenAI from "openai";
const client = new OpenAI({
  apiKey: process.env.YUNWU_API_KEY,
  baseURL: "https://yunwu.ai/v1",
});
const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "你好，请用一句话介绍你自己。" }],
  temperature: 0.7,
});
console.log(resp.choices[0]?.message?.content);

#Vercel AI SDK（支持 generateObject 结构化出稿）

import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
const client = createOpenAICompatible({
  name: "yunwu",
  apiKey: process.env.YUNWU_API_KEY!,
  baseURL: "https://yunwu.ai/v1",
  supportsStructuredOutputs: true,   // 必开，否则 generateObject 不下发 response_format
});
const model = client(process.env.LLM_MODEL || "deepseek-v4-flash");

#cURL

curl -X POST "https://yunwu.ai/v1/chat/completions" \
  -H "Authorization: Bearer $YUNWU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"你好"}]}'

#有哪些模型可用（422 条 / 22 家供应商）

完整清单 + 各家定价见《云雾供应商与令牌倍率机制》（DeepSeek 全 21 款、各家旗舰价、令牌倍率都在里面）。下面只列最常用几个：

模型名 说明
deepseek-v4-flash 默认，DeepSeek 快版，便宜快，结构化 json_schema 稳定
deepseek-v4-pro DeepSeek 旗舰，质量更高、更贵
deepseek-chat DeepSeek 官方别名，自动指向当时最新对话模型
gpt-5.5-pro OpenAI 旗舰
claude-opus-4-8 Anthropic 旗舰（模型名以控制台为准）
gemini-2.5-pro Google 旗舰
qwen3.7-max / glm-4.6 / grok-4.5 千问 / 智谱 / xAI

拉当前完整可用列表（模型名会更新，以此为准）：

curl -s "https://yunwu.ai/v1/models" -H "Authorization: Bearer $YUNWU_API_KEY" | jq '.data[].id'

或到控制台 https://yunwu.ai/ 查「模型列表 / 令牌管理」。

#实战经验（迁移时照做）

  • 结构化出稿必开 supportsStructuredOutputs: true：用 Vercel AI SDK 的 generateObject 时，不开这个开关模型会返回裸文本，解析为空整篇丢失。
  • deepseek-v4-flash / v4-pro 对 json_schema 稳定（实测）；有些模型（千问 max、Kimi k2.5/k2.6）接了 json_schema 却不遵循，会退化成裸数字或 markdown，结构化场景避开或加降级。
  • 中转会偶发抖动：中转站比官方多一跳，建议调用方保留重试 / Promise.allSettled 兜底（各条独立 settle，挂一条不影响整篇）。
  • 切回官方直连：LLM_PROVIDER=deepseek 即走 DeepSeek 官方 API（需 DEEPSEEK_API_KEY），代码无需改，两条路都在模型工厂里。

来源：配置信息/云雾API-中转/README.md（整理于 2026-08-18）

相关笔记