免费额度
¥0100 次/日 / Key
用于联调与评估，无需付费即可跑通全流程
能力目录
接口一览
路径与字段以开放平台文档中心为准；标注「内测中」的能力当前可申请开通。
| 方法 | 路径 | 能力 | 说明 | 状态 |
|---|---|---|---|---|
| POST | /v1/ai/pest-recognize | 病虫害识别 | 上传图片，返回类别、置信度与处置处方 | 内测中 |
| POST | /v1/ai/growth-recognize | 长势/杂草识别 | 评估出苗率、株高与长势等级，返回处方图 | 规划中 |
| POST | /v1/ai/agri-qa | 农技问答 | 检索增强问答，返回答案与引用来源 | 规划中 |
| GET | /v1/devices | 设备列表 | 查询租户下设备与在线状态 | 内测中 |
| GET | /v1/telemetry | 遥测数据 | 按设备与时间范围查询遥测序列（必带时间范围） | 内测中 |
| GET | /v1/alerts | 告警列表 | 查询告警与处置状态 | 规划中 |
快速开始
三步拿到第一个识别结果
- 1
注册并实名认证
在开放平台注册账号，完成主体认证（内测阶段由商务开通）。
- 2
创建 API Key
在控制台创建 Key，默认获得免费额度（100 次/日）。
- 3
按文档调用
使用 curl 或 SDK 调用识别接口，5 分钟内拿到第一个结果。
curl
curl -X POST https://ai.aiotagro.com/api/v1/ai/pest-recognize \
-H "X-API-Key: $AIOTAGRO_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "image=@leaf.jpg" \
-F "crop=strawberry"
# 200 OK
{
"code": 0,
"data": {
"label": "白粉病",
"confidence": 0.93,
"prescription": "摘除病叶；加强通风降湿；按当地植保指南轮换用药",
"suggestion_id": "sug_20261016_0001"
}
}Node.js · fetch
import { readFile } from 'node:fs/promises'
const res = await fetch('https://ai.aiotagro.com/api/v1/ai/pest-recognize', {
method: 'POST',
headers: { 'X-API-Key': process.env.AIOTAGRO_API_KEY! },
body: (() => {
const fd = new FormData()
fd.append('crop', 'strawberry')
return fd
})(),
})
const { data } = await res.json()
console.log(data.label, data.confidence, data.prescription)额度与计费
先免费，后按量
内测阶段能力开通由商务审核；以下为 v1 设计口径，最终以开放平台计费页为准。
API 按量计费
按调用量分档定价
识别类按图片张数计费，问答类按调用次数计费，账单 T+1 可查
SaaS 订阅
30–80 元亩 / 年（参考区间）
控制台订阅：设备接入、看板、告警闭环；按设备数或亩数计费
错误码
| 业务码 | HTTP | 说明 |
|---|---|---|
0 | 200 | 成功 |
INVALID_PARAM | 400 | 参数缺失或格式错误 |
UNAUTHORIZED | 401 | API Key 缺失或失效 |
QUOTA_EXCEEDED | 429 | 超出配额（含免费额度） |
IMAGE_TOO_LARGE | 413 | 图片超过 10MB 上限 |
MODEL_BUSY | 503 | 推理队列繁忙，请重试或改用异步接口 |
- 当前开放平台处于内测阶段，能力开通需完成主体认证并由商务审核。
- 接口路径、字段与计费口径以开放平台文档中心为准；本页内容为 v1 设计稿。
- 识别结果为辅助决策信息，涉及用药与植保处置请遵循当地植保部门指南。