SuperAPI AI 工具集

roboflow-api-reference

编程与开发

查看项目

更新于 10-15 22:10

技能介绍

本资料是 Roboflow 计算机视觉技能的 API 参考,面向智能体提供 REST 与推理 API 的协议级事实。用途:说明 API 主机、认证、参数、错误码以及 SDK 快速上手,部署策略等不在本页范围。

API 主机:平台 API 为 https://api.roboflow.com,用于项目、图片、版本、训练、上传等 CRUD;无服务器推理为 https://serverless.roboflow.com,用于模型推理与 Workflow 执行;专用部署为 https://<name>.roboflow.cloud,提供私有 GPU 推理且 API 与无服务器一致;自托管推理为 http://localhost:9001。

认证:所有主机支持查询参数 ?api_key=YOUR_KEY;平台 API 与 Workflow 推理支持请求体中的 "api_key";MCP 服务器使用请求头 x-api-key,由 MCP 自动处理。API 密钥按工作区划分,可在 Roboflow 仪表盘的工作区设置中获取。

SDK:Python inference-sdk 用 pip install inference-sdk,作为所有推理主机的首选客户端;Python roboflow 用 pip install roboflow,用于上传、训练、项目管理;JavaScript roboflow.js 通过浏览器脚本标签用于实时端上 Web 推理;iOS 通过 CocoaPods/SPM 用于端上移动推理。

使用方式:本地有 roboflow:<name> 技能时优先使用,插件每次会话从磁盘重新读取;无插件客户端可用 MCP 资源 roboflow://skills/<name>/... 作为回退,可能滞后。若已连接 Roboflow MCP 服务器,优先用其工具而非原始 REST 调用,工具可处理认证、分页和类型化响应。实时视频、摄像头或 RTSP 需通过 inference_sdk.webrtc 走 WebRTC,不是普通 HTTP 调用。

限制:无服务器 API 的速率限制因套餐而异,资料未给出具体数值;文件上传最大 20 MB。创建密钥时若工作区支持高级 API 密钥,应按最小权限限定范围;否则告知用户作用域密钥为企业版功能。相关子页涉及推理、平台 REST、密钥管理。