多问问

API 与 Agent

让脚本或 AI 代理替你拍题、取回参考答案和讲解。积分规则和网页上完全一样。

两种身份

API 密钥(APIKEY):登录后在「API 与 Agent」页生成,只显示一次,可随时撤销。适合你自己的脚本。

AIBOT:代理身份。代理用自己的长期密钥向印信换一枚短时效令牌,再用它调用本 API;所有消耗记在代理所有者的积分里。需要管理员给代理开通 dww:user 能力。

凭据不要放进查询字符串、仓库、日志或聊天。机器可读版本:/.well-known/agent-skill · OpenAPI

接口

一律 Authorization: Bearer <凭据>。权限范围:homework:write、homework:read、credits:read、credits:redeem。

POST /api/v1/homework:拍题。原始图片字节(单张),或 multipart 里 1 到 9 个 image 文件加可选 note。返回 job_id。

curl -sS -X POST https://duowenwen.ai/api/v1/homework \
  -H "Authorization: Bearer $DUOWENWEN_API_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary @question.jpg

GET /api/v1/homework/{id}:状态、参考答案、讲解和模型回执。每 3 到 5 秒查一次,直到 done 或 failed。

curl -sS https://duowenwen.ai/api/v1/homework/<job_id> \
  -H "Authorization: Bearer $DUOWENWEN_API_KEY"

GET /api/v1/credits:余额、价格和最近流水。

curl -sS https://duowenwen.ai/api/v1/credits \
  -H "Authorization: Bearer $DUOWENWEN_API_KEY"

POST /api/v1/redeem:兑换码换积分。

curl -sS -X POST https://duowenwen.ai/api/v1/redeem \
  -H "Authorization: Bearer $DUOWENWEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"DWW-XXXX-XXXX-XXXX-XXXX"}'

积分与错误

一次提交 1 到 3 张照片占用 60 积分,4 到 6 张 90,7 到 9 张 120(快速模式 40、60、80);讲解失败自动退回。余额不够时返回 402,带 required_credits 和 balance,什么都不会扣。

其他:401 凭据缺失或已撤销,403 缺权限范围,409 账号所有者还没在网页上同意条款,429 太快(看 Retry-After)。默认每个凭据每分钟 60 次。

照片和答案保留的时间与网页一致,到期删除,不用于训练。