概览

SciDraw AI 的 REST API 通过稳定的任务制接口提供图片生成、图片编辑和格式转换能力。

基础地址： https://sci-draw.com

机器可读的接口描述： OpenAPI JSON · OpenAPI YAML

这两个文件用 OpenAPI 格式描述的是同一套接口。把任意一个导入 Postman 或 Insomnia，所有端点和参数会自动填好；喂给代码生成器可以直接产出带类型的客户端； 交给 AI 智能体，它就能自己调用而不需要你手写请求。两种格式内容等价，用你的工具 支持的那种即可。

快速开始

1. 在设置 → API 密钥创建密钥，只选择业务实际需要的权限。
2. 使用 Authorization: Bearer sd_... 传递密钥。
3. 每个创建请求都必须携带唯一的 Idempotency-Key。
4. 保存返回的任务 ID，并轮询 Location 地址，直到任务进入 succeeded、failed 或 canceled。

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

创建请求通常返回 202 Accepted、任务对象、Location 和 Retry-After: 2。可以增加 Prefer: wait=10，最多等待 10 秒。等待不会改变 任务机制：只有任务已经结束时才返回 200，否则仍返回 202。

接口列表

所有响应均为 JSON 包装对象，并包含 X-Request-Id。联系支持时请提供该 ID。 对外只返回公开文件 ID 和结果 URL；能力调度由 SciDraw AI 管理。