教程 / 接入
在 LangChain 与 Dify 里配置
两个框架都只需要填 Base URL、API Key 和模型名,但各自的“兼容供应商”能覆盖的范围不一样。
LangChain
用 ChatOpenAI,把 base_url 指向 Aisoui,model 填平台上的模型 ID。链、工具、记忆这些都不用改。
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="gemini-3.8-flash",
base_url="https://api.aisoui.com/v1",
api_key="sk-live-你的密钥",
temperature=0.7,
)
print(llm.invoke("用一句话说明什么是流式输出").content)Dify
- 设置 → 模型供应商 → 添加 OpenAI-API-compatible。
- Base URL 填 https://api.aisoui.com/v1,末尾不要多写 /chat/completions。
- API Key 填 sk-live- 开头的密钥;模型名称填平台上的模型 ID,类型选对话。
- 保存后先在“系统模型设置”里测一次连通性,再去编排。
Dify 的 OpenAI 兼容供应商主要覆盖对话和向量检索。图片、音乐这类能力不在它的兼容范围里,需要在工作流里用 HTTP 请求节点直接调 /v1beta 端点。
排查顺序
| 现象 | 先看这里 |
|---|---|
| 保存时就报连接失败 | Base URL 是否多了 /v1/v1 或少了 /v1 |
| 能连上但调用报模型不存在 | 模型名是否填成了显示名(要填 ID,如 gemini-3.8-flash) |
| 对话正常、工具调用异常 | 该模型对函数调用的支持情况,先用纯对话验证链路 |
| 长文报超时 | 框架侧超时设置,以及是否误开了流式但前端没消费 |
常见问题
- 可以用 Dify 的“OpenAI”供应商直接填吗?
- 可以,但要用 OpenAI-API-compatible 这一项,并且手动改 Base URL;用官方 OpenAI 供应商会固定走 api.openai.com。
- Embedding 模型有吗?
- 当前对外提供的是 Gemini 系列的对话、图片、视频、音乐与语音能力,向量模型请以控制台的模型列表为准。
接着看
照着跑一遍
注册后拿密钥,把示例里的 YOUR_API_KEY 换掉就能跑。