~/docs/getting-started/auth/

鉴权

蜀农 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 请求频率或额度超限 降低请求速率,稍后重试或检查余额