APIPace 文档 API 参考

接入 Dify

Dify 里装一个 OpenAI-API-compatible 模型供应商,之后所有应用(聊天助手、工作流、Agent)都能选到这里的模型。

配置

  1. 设置 → 集成 → 模型供应商,找到 OpenAI-API-compatible 并安装。
  2. 在它的卡片上点 添加模型。
  3. 填这几个字段:
字段 填什么
模型类型 LLM
模型名称 别名本身,如 claude-sonnet-4.6
API Key 你的 ak-…
API Base URL https://api.apipace.com/v1
模型上下文长度 必填,按该模型的实际上下文填,如 200000
最大 token 上限 按需,如 8192
  1. 保存。

API Base URL 必须带 /v1——这个字段是完整前缀,Dify 会直接在后面拼 /chat/completions。

每个别名要单独加一次

Dify 的这个供应商是 customizable-model 型的:不会自动拉模型列表,每个别名都得手工添一条。要用三个模型就添三次,别在「模型名称」里填一堆。

想省事的话,先想清楚这个 Dify 实例真正要用哪几个别名——通常两三个就够(一个主力、一个便宜的跑批)。

模型名就是别名

Dify 把「模型名称」原样发成请求里的 model。填错会拿到:

{"error":{"code":"MODEL_NOT_FOUND","message":"unknown model \"gpt-4o\"","request_id":"req_…"}}

想用 Anthropic 协议

Dify 的 Anthropic 供应商也支持自定义地址,字段叫 API URL,填 https://api.apipace.com——根地址,不带 /v1,和上面的 OpenAI-API-compatible 正好相反。Dify 把它原样交给 Anthropic SDK,SDK 自己补 /v1/messages。

建议给 Dify 单开一把 key

在控制台按项目建 key,Dify 用一把、别的用别的。这样 GET /v1/user/statement 的 keys[] 能把 Dify 的花费单独拆出来,控制台用量页也能按项目看。

常见问题

保存时校验失败 —— Dify 会发一次真实请求来验证。检查 API Base URL 有没有 /v1、模型名是不是别名、key 有没有多余空格。

Embedding / Rerank 模型加不上 —— 这里暂不提供 embeddings(/v1/embeddings 返回 501)。Dify 的向量检索请另配一个 embedding 供应商。

工作流里模型选不到 —— 添完刷新一下页面;确认添的时候「模型类型」选的是 LLM。

上下文长度填错的后果 —— Dify 按这个数字裁历史。填大了会把超长请求发出来,模型那边直接报错;填小了会提前丢上下文。