API 文档

图表生成

从数据表生成期刊风格的统计图表

POST /api/v1/charts/generations 使用 multipart/form-data。所需权限：charts:generate。服务会读取你的数据表，自动选择或按指定的图表类型绘图，最终返回一张完成的 PNG 图片。不暴露流式输出或中间状态，像其他任务一样轮询即可。

表单字段

字段	类型	必填	默认值	规则
`data`	file	是	—	CSV、TSV、TXT、XLSX 或 XLS；最大 5 MB；首行必须是唯一的列名
`prompt`	string	否	—	希望展示或强调的内容，最多 8,000 字符
`chart_types`	string	否	自动	逗号分隔或重复传入，最多 4 个，取值见下方列表
`journal_style`	string	否	`default`	`default`、`nature`、`science`、`cell`、`plos` 或 `acs`
`figure_width`	string	否	`double`	`single`（单栏）或 `double`（双栏）
`color_palette`	string	否	`okabe_ito`	`okabe_ito`、`wong`、`tol_bright` 或 `tol_muted`

无法解析、超过大小限制、列名重复或为空的文件返回 400 INVALID_REQUEST（超大文件的 HTTP 状态为 413）。

图表类型

bar, line, scatter, boxplot, violin, histogram, heatmap, regression, errorbar, , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , .

图片转换

将图片转换为 SVG、PPTX、PNG、PDF 或 TIFF

任务与有限等待

轮询异步任务并读取经过清理的结果

目录

timeseries

volcano

kaplan_meier

forest

dot

radar

upset

dendrogram

qq

ogive

funnel

density

roc

sankey

stem_leaf

correlation

pca

manhattan

bland_altman

waterfall

dose_response

growth_curve

standard_curve

raincloud

beeswarm

ecdf

ma_plot

enrichment

enzyme_kinetics

calendar_heatmap

choropleth

stacked_area

ridgeline

bubble

hexbin

paired_dot

precision_recall

calibration_curve

confusion_matrix

curl https://sci-draw.com/api/v1/charts/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: study-12-figure-2' \
  -H 'Prefer: wait=30' \
  -F 'data=@results.csv;type=text/csv' \
  -F 'prompt=比较各处理组并标注显著性' \
  -F 'chart_types=boxplot' \
  -F 'journal_style=nature' \
  -F 'figure_width=single'

const form = new FormData();
form.set('data', file);
form.set('prompt', '比较各处理组并标注显著性');
form.set('chart_types', 'boxplot');
const response = await fetch('https://sci-draw.com/api/v1/charts/generations', {
  method: 'POST',
  headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
  body: form,
});

with open("results.csv", "rb") as table:
    response = requests.post(
        "https://sci-draw.com/api/v1/charts/generations",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"data": ("results.csv", table, "text/csv")},
        data={"prompt": "比较各处理组并标注显著性", "chart_types": "boxplot"},
    )