API ドキュメント

画像変換

画像を SVG・PPTX・PNG・PDF・TIFF に変換する

POST /api/v1/images/conversions は multipart/form-data を受け付けます。必要なスコープ：images:convert。

フォームフィールド

フィールド	型	必須	既定値	制約
`image`	file	はい	—	PNG・JPEG・WebP、最大 10 MiB かつデコード後 4,000 万ピクセルまで
`format`	string	はい	—	`svg`、`pptx`、`png`、`pdf`、`tiff`
`vector_mode`	string	いいえ	`editable_text`	SVG のみ
`dpi`	string	いいえ	`300`	`300`、`600`、`1000`。PNG・PDF・TIFF のみ

2 つの SVG モード

SVG の 2 つの選択肢はどちらも実装済みで、同じエンドポイントから利用できます：

`vector_mode`	結果	クレジット
`editable_text`	可能な範囲でテキストを編集できる SVG	10
`full_vector`	完全にベクター化された SVG 出力	15

これらの名前は出力の性質を表すものです。能力のルーティングは SciDraw AI が管理しており、公開契約には含まれません。

その他の形式とクレジット

画像編集

アップロードした画像を自然言語の指示で編集する

グラフ生成

データ表から論文向けのグラフを生成

目次

フォームフィールド

2 つの SVG モード

その他の形式とクレジット

cURL：テキスト編集可能な SVG

curl https://sci-draw.com/api/v1/images/conversions \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: figure-12-svg-editable' \
  -F 'image=@figure.png;type=image/png' \
  -F 'format=svg' \
  -F 'vector_mode=editable_text'

const form = new FormData();
form.set('image', file);
form.set('format', 'svg');
form.set('vector_mode', 'full_vector');
const response = await fetch('https://sci-draw.com/api/v1/images/conversions', {
  method: 'POST',
  headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
  body: form,
});

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/conversions",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("figure.png", image, "image/png")},
        data={"format": "svg", "vector_mode": "full_vector"},
    )