鉴权
蜀农 API 使用 Bearer Token 鉴权。将 API Key 放入 Authorization 请求头,并在请求中设置 JSON 内容类型。
请求头
Authorization: Bearer $SHUNONG_API_KEY
Content-Type: application/json
curl 示例
curl https://ai.agriwis.com/api/v1/chat/completions \
-H "Authorization: Bearer $SHUNONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [{"role": "user", "content": "你好"}]
}'
SDK 配置
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["SHUNONG_API_KEY"],
base_url="https://ai.agriwis.com/api/v1",
)
安全注意事项
API Key 应只在可信的后端环境中使用。浏览器端请求会暴露密钥,建议由你的后端代理调用蜀农 API,并在代理层实施用户鉴权、限流和用量控制。
常见鉴权错误
| 状态码 | 含义 | 处理方式 |
|---|---|---|
401 |
密钥缺失或无效 | 检查环境变量、请求头和密钥状态 |
403 |
当前账号无权访问 | 检查账号权限和模型权限 |
429 |
请求频率或额度超限 | 降低请求速率,稍后重试或检查余额 |