ollama-api-skill
提供与Ollama API集成的完整指南与实用代码
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ollama-api-skill。 它的用途是：提供与Ollama API集成的完整指南与实用代码 完整的 Skill 内容见：https://321skill.com/skills/ollama-api-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在用Python开发一个智能体，需要根据用户问题动态选择最合适的Ollama模型来处理，比如有的问题需要看图，有的需要调用工具。” 它会引导你查阅Skill中关于模型能力检测和路由模式的章节，并提供相应的代码片段。或者，当你说：“我的Ollama服务远程访问时报CORS错误。” 它会直接指向Skill的故障排查部分，给出常见的解决方案。
介绍
本Skill旨在解决开发者在集成和使用Ollama本地或远程API时遇到的复杂问题。它提供了从基础API调用到高级功能（如模型能力动态检测、多模态输入处理、图像生成）的全面指导。
Skill通过详尽的API参考文档、能力检测说明、代码示例和故障排查指南来指导用户。开发者可以参照文档快速构建能够智能调用不同模型、处理流式响应和结构化输出的AI应用。
它非常适合需要直接与Ollama交互的AI应用开发者、智能体构建者以及希望设计模型路由系统的工程师。无论是构建聊天机器人、内容生成工具还是复杂的多模型代理，都能从中找到解决方案。
使用建议：在开始开发前，先通过/api/show端点了解目标模型的能力状态。对于生产环境，注意处理好能力回退机制和错误处理，并参考云部署与安全相关的最佳实践。
核心特点
本Skill的核心在于提供了详尽的模型能力动态检测（confirmed, inferred, pending状态）与路由机制指南，这是许多同类API封装库所缺乏的。同时，它深度覆盖了Ollama特有的功能，如基于扩散模型的图像生成、OpenAI兼容层以及针对MLX等特定运行时的故障排查，而非仅提供通用的HTTP客户端示例。
注意事项
本Skill主要提供指南和代码示例，并非一个开箱即用的封装库或框架，需要开发者具备一定的编程和集成能力。
常见问题
如何检测一个Ollama模型是否支持视觉或工具调用？
通过调用`/api/show`端点并解析返回的模型元数据，根据`capabilities`字段中的`confirmed`、`inferred`等状态来判断。
Ollama的API和OpenAI的API兼容吗？
Ollama提供了`/v1/`开头的兼容性端点，可以部分兼容OpenAI客户端库，方便迁移，但并非完全一致。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ollama-api-skill/raw/index.md 读取 ollama-api-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ollama-api-skill/raw/index.md（查看排版版本）