API 概览

PaperBanana HTTP API：将生成、续跑、评测能力统一封装为异步任务接口。 通用流程： 1. 提交任务（POST） 2. 轮询状态（GET /api/v1/tasks/{task_id}） 3. 下载结果（GET /api/v1/tasks/{task_id}/artifact）

调用流程：提交任务 -> 轮询状态 -> 下载结果。任务均为异步执行。

鉴权

除心跳检测与文档接口外，业务接口都需要 Bearer Token。

/health

用于检测服务是否存活。

curl -X GET "https://api.paperbanana.me/health"

/api/v1/tasks/generate

提交方法图生成任务，返回 task_id 后异步执行。

application/json

{
  "source_context": "我们的方法分为检索、规划、迭代精化三个阶段。",
  "communicative_intent": "方法整体流程图",
  "refinement_iterations": 3,
  "optimize_inputs": true
}

curl -X POST "https://api.paperbanana.me/api/v1/tasks/generate" -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
  "source_context": "我们的方法分为检索、规划、迭代精化三个阶段。",
  "communicative_intent": "方法整体流程图",
  "refinement_iterations": 3,
  "optimize_inputs": true
}'

/api/v1/tasks/plot

提交统计图生成任务，支持自定义 JSON 数据。

application/json

{
  "intent": "比较不同模型在三个基准上的准确率",
  "raw_data": {
    "models": [
      "A",
      "B",
      "C"
    ],
    "mmlu": [
      85.2,
      88.1,
      90.3
    ],
    "arc": [
      78.0,
      80.5,
      82.9
    ]
  },
  "refinement_iterations": 2
}

curl -X POST "https://api.paperbanana.me/api/v1/tasks/plot" -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
  "intent": "比较不同模型在三个基准上的准确率",
  "raw_data": {
    "models": [
      "A",
      "B",
      "C"
    ],
    "mmlu": [
      85.2,
      88.1,
      90.3
    ],
    "arc": [
      78.0,
      80.5,
      82.9
    ]
  },
  "refinement_iterations": 2
}'

/api/v1/tasks/continue

继续已有 run 的迭代优化，支持用户反馈。

application/json

{
  "run_id": "run_20260226_120000_ab12cd",
  "additional_iterations": 2,
  "user_feedback": "把箭头更粗一些，阶段颜色区分更明显。"
}

curl -X POST "https://api.paperbanana.me/api/v1/tasks/continue" -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
  "run_id": "run_20260226_120000_ab12cd",
  "additional_iterations": 2,
  "user_feedback": "把箭头更粗一些，阶段颜色区分更明显。"
}'

/api/v1/tasks/evaluate

上传生成图与参考图，异步返回结构化评测结果。

multipart/form-data

curl -X POST "https://api.paperbanana.me/api/v1/tasks/evaluate" -H "Authorization: Bearer " \
  -F "generated_image=@generated.png" \
  -F "reference_image=@reference.png" \
  -F "source_context=..." \
  -F "caption=..."

/api/v1/tasks/{task_id}

轮询任务状态，直到状态变为完成或失败。

curl -X GET "https://api.paperbanana.me/api/v1/tasks/{task_id}" -H "Authorization: Bearer "

/api/v1/tasks/{task_id}/artifact

下载任务最终产物（图片或 JSON）。

curl -X GET "https://api.paperbanana.me/api/v1/tasks/{task_id}/artifact" -H "Authorization: Bearer "