画像変換

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 が管理しており、公開契約には含まれません。

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

形式	オプション	クレジット
`pptx`	—	10
`png`、`pdf`、`tiff`	`dpi=300`	5
`png`、`pdf`、`tiff`	`dpi=600`	10
`png`、`pdf`、`tiff`	`dpi=1000`	15

SVG 以外の形式に full_vector を指定した場合、または SVG・PPTX に既定以外の DPI を指定した場合は 400 INVALID_REQUEST を返します。

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'

JavaScript

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

Python

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

2 つめの SVG 出力を使うには vector_mode=full_vector を指定します。成功したジョブの result.files[0] には format、mime_type、ダウンロード URL が含まれます。

VSDX (Visio)

ウェブアプリでは、図表画像を編集可能な Microsoft Visio（VSDX）ファイルとして再構築することもできます。図形・コネクタ・テキストが移動可能なネイティブオブジェクトになります。この機能は画像変換ツールと AI Drawing エディタで利用でき、本 API では提供していません。

独自のパイプラインで VSDX 変換が必要な場合：この機能は LayerBack によって提供されており、図表画像を VSDX に変換する専用 REST API があります。LayerBack API ドキュメントをご覧ください。