API ドキュメント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 が管理して おり、公開契約には含まれません。
その他の形式とクレジット
| 形式 | オプション | クレジット |
|---|---|---|
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
Python
with open("figure.png", "rb") as image:
response = requests.post(
"https://sci-draw.com/api/v1/images/conversions",
headers={"Authorization": f"Bearer
2 つめの SVG 出力を使うには vector_mode=full_vector を指定します。成功した
ジョブの result.files[0] には format、mime_type、ダウンロード URL が
含まれます。