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`(1단) 또는 `double`(2단)
`color_palette`	string	아니요	`okabe_ito`	`okabe_ito`, `wong`, `tol_bright`, `tol_muted`

구문 분석할 수 없거나 크기 제한을 초과하거나 열 이름이 중복·비어 있는 파일은 400 INVALID_REQUEST를 반환합니다(크기 초과 시 HTTP 상태는 413).

차트 종류

bar, line, scatter, boxplot, violin, , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , .

이미지 변환

이미지를 SVG, PPTX, PNG, PDF, TIFF로 변환하기

작업과 제한 대기

비동기 작업을 폴링하고 정제된 결과 읽기

목차

histogram

heatmap

regression

errorbar

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"},
    )