惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

The GitHub Blog
The GitHub Blog
阮一峰的网络日志
阮一峰的网络日志
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
Apple Machine Learning Research
Apple Machine Learning Research
小众软件
小众软件
博客园 - 司徒正美
Last Week in AI
Last Week in AI
爱范儿
爱范儿
罗磊的独立博客
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
博客园_首页
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
The Cloudflare Blog
雷峰网
雷峰网
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
WordPress大学
WordPress大学
Jina AI
Jina AI
人人都是产品经理
人人都是产品经理
量子位
V
V2EX
博客园 - 叶小钗
宝玉的分享
宝玉的分享
T
Tailwind CSS Blog

博客园 - VipSoft

FastAPI 全局 HTTP 异常处理器 + 统一响应封装 SpringBoot 心跳日志不记录 access.log Qdrant Linux 安装(非Docker) LangChain — RAG 知识库(实操) LangChain — RAG 构建知识库(理论) LangChain — RAG 构建知识库(实操) Python PyCharm 运行,取不到 .env 文件中的值 Qdrant 安装(Windows) LangChain — RAG 构建知识库 Python 项目简单部署(Linux) MinerU - 将非结构化文档(PDF、图片、Office 文件等)转换为机器可读的 Markdown 和 JSON LangChain 入门 服务端部署-FastAPI LangChain 入门 LangSmith LangChain 入门 实战 - 食谱推荐 LangChain 入门 Memory 会话记忆 LangChain 入门 Tools 工具 LangChain 入门 Tools 工具 LangChain 入门 Prompts 提示词 LangChain 入门 Message 消息 LangChain 入门 Model 的初始化和调用 LangChain 入门 Agent 的基本运行机制 AI 0基础学习,名词解析 LangChain 和 LangGraph AI大模型知识体系 Dify — Workflow - 数据可视化 Dify — 连接MySQL配置 Dify — Chatflow - 数据库智能查询 Dify — Chatflow - 文档知识库 Dify — Agent 智能体 高安全券码、注册码生成
Ollama — 接口
VipSoft · 2026-05-22 · via 博客园 - VipSoft

有,而且非常多。Ollama 的 API 体系分为两套:原生 API(功能最全)和 OpenAI 兼容 API(生态通用)。

对于你的“合同解析”项目,除了 /api/generate,这几个接口最值得关注:

一、核心必用接口(你的项目刚需)

端点 方法 核心用途 为什么对你的项目很重要
/api/chat POST 多轮对话(推荐) 天然支持 messages 数组,比单 prompt 更易维护上下文,且同样支持 format: json
/api/tags GET 列出本地模型 检查你的 vipsoft 模型是否已创建成功。
/api/show POST 查看模型详情 查看 vipsoft 的 Modelfile 配置(如 num_ctx 是否生效)。
/api/delete DELETE 删除模型 清理旧测试模型,释放磁盘空间。

二、原生 API 完整清单

除了上述核心接口,Ollama 还提供了一套完整的模型管理 API:

  • /api/generate:你正在用的,单次文本补全。
  • /api/chat更现代的聊天接口,使用 messages 数组(含 role)来维持对话记忆。
  • /api/embeddings:生成文本向量(如果你后续要做语义检索)。
  • /api/pull:拉取远程模型(类似 ollama pull)。
  • /api/create:通过 API 直接创建自定义模型(无需命令行)。
  • /api/copy:复制模型。
  • /api/ps:查看当前正在运行的模型进程。

三、OpenAI 兼容接口(生态杀手锏)

Ollama 在 http://localhost:11434/v1/ 路径下提供了一组完全兼容 OpenAI 格式的接口。这意味着你可以直接使用为 ChatGPT 编写的 SDK 或代码来调用本地模型。

  • /v1/chat/completions:对应原生的 /api/chat
  • /v1/embeddings:对应原生的 /api/embeddings
  • /v1/models:对应原生的 /api/tags

Python 示例(使用 OpenAI SDK 调用本地 Ollama):

# 安装 openai 包:pip install openai
from openai import OpenAI

# 将 client 指向你的本地 Ollama 服务
client = OpenAI(
    base_url='http://localhost:11434/v1',
    api_key='ollama'  # 本地通常无需验证,但必须传一个非空值
)

# 像调用 ChatGPT 一样调用你的 vipsoft 模型
response = client.chat.completions.create(
    model="vipsoft",  # 你的自定义模型名
    messages=[
        {"role": "system", "content": "你是合同解析助手"},
        {"role": "user", "content": "解析这份合同..."}
    ],
    temperature=0.1
)

print(response.choices[0].message.content)

四、快速验证命令(终端测试)

你可以直接在 CMD 或 PowerShell 中运行以下命令快速体验:

  1. 查看模型列表
    curl http://localhost:11434/api/tags
    
  2. 使用 Chat API(推荐替代 Generate)
    curl http://localhost:11434/api/chat -H "Content-Type: application/json" -d '{
      "model": "vipsoft",
      "messages": [
        { "role": "user", "content": "你是谁?" }
      ],
      "stream": false,
      "format": "json"
    }'
    

五、官方文档入口

  • 官网文档https://docs.ollama.com/api
  • 在线文档https://github.com/ollama/ollama/blob/main/docs/api.md(最详细)。

建议:在你的合同解析 Python 代码中,优先考虑迁移到 /api/chat/v1/chat/completions。因为 messages 结构比拼接长字符串更清晰,也更利于未来扩展多轮问答(比如先让模型确认合同类型,再执行解析)。