# 画像変換

画像を SVG にベクター化、または PNG、PDF、TIFF、PPTX に書き出します。フローチャートにも対応します。

出典：https://scifig.ai/ja/docs/api/image-conversions

## JSON 本文

`POST /images/conversions`。必要なスコープ：`figures:generate`。

| フィールド | 型 | 必須 | 既定値 | 規則 |
| --- | --- | --- | --- | --- |
| image | string | はい | — | 最大 20 MB の PNG または JPEG の `file_id`、またはフローチャートの SVG 出力。`svg` は WebP も対応 |
| format | string | はい | — | `svg`、`png`、`pdf`、`tiff`、`pptx` のいずれか |
| vector_mode | string | いいえ | `editable_text` | `svg` のみ：`editable_text` または `full_vector` |
| dpi | integer | いいえ | 300 | `svg` 以外：300、600、1000 |
| width | integer | いいえ | 2048 | フローチャート SVG のみ：長辺のピクセル数 256～4096、総ピクセル数は最大 4,194,304 |

## SVG ベクター化

- 150 クレジットで、有料プランが必要です。ウェブサイトのキャンバス編集と同じベクター化処理を使用します。入力は PNG、JPEG、WebP 画像です。
- `editable_text` は文字を編集可能な SVG テキストとして保持し、`full_vector` は文字を含むすべての要素をパスに変換します。
- ジョブとして実行されます。ベクター化タスクが受け付けられた後にのみクレジットを確保し、ジョブの `credits` は台帳から読み取ります。ベクター化が失敗すると返金され、そのキーに対して `TASK_FAILED` を返します。
- すでにベクター化された画像を変換すると、以前の SVG を返し、このジョブには課金しません。
- タスク開始前にベクター化サービスが一時的に利用できない場合は、`Retry-After` 付きの `503 SERVICE_UNAVAILABLE` を返します。同じキーで再試行してください。

## PNG、PDF、TIFF、PPTX

- 無料で、アカウントごとに 1 日最大 200 回変換できます。即時に完了し、レスポンスは `succeeded` のジョブです。
- 変換は、入力がすべての検証を通過してから、Idempotency-Key ごとに一度だけ日次枠に数えます。同じキーでの再試行は重複して数えません。枠を超えると、`details.reason = DAILY_CONVERSION_LIMIT` と日次枠がリセットされるまでの `Retry-After` を伴う `429 RATE_LIMITED` を返します。
- 入力は PNG、JPEG 画像、またはフローチャートの SVG 出力です。WebP は使用できません（`UNSUPPORTED_SOURCE_FORMAT`）。
- エンコード後の出力が 24 MiB を超えるファイルは `400 INVALID_REQUEST`（`OUTPUT_TOO_LARGE`）で拒否されます。より小さい画像を変換してください。
- `dpi` はファイルに書き込まれ、PDF と PPTX の実寸ページサイズを決めます。ピクセルの再サンプリングは行いません。ピクセル数を増やすには、先に[高解像度化](/ja/docs/api/image-upscales)してください。
- PNG と TIFF の入力には PNG が必要です。PDF と PPTX は JPEG も使用できます。TIFF は可逆の Deflate 圧縮を使用します。
- PPTX は画像を配置した 1 枚のスライドで、編集可能な図形ではありません。

## フローチャートの書き出し

フローチャートの SVG 出力は PNG、PDF、TIFF、PPTX に変換できます。サーバーは Arial と Noto フォントを使用し、長辺を `width` ピクセルで描画します（既定値 2048、最大 4096、総ピクセル数は最大 4,194,304。正方形では最大 2048 px）。上限を超える指定は `400 INVALID_REQUEST`（`RENDER_TOO_LARGE`）を返します。フォントで表示できない文字は空の四角にせず、`400 INVALID_REQUEST`（`SVG_NOT_RENDERABLE`）で拒否します。描画サービス自体の障害は `Retry-After` 付きの `503 SERVICE_UNAVAILABLE`（`SVG_RENDERER_UNAVAILABLE`）を返すため、同じキーで再試行してください。その他の SVG ファイルは入力に使用できません。

## cURL

```bash
curl -X POST https://scifig.ai/api/v1/images/conversions \
  -H "Authorization: Bearer $SCIFIG_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=25" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "<file_id>",
    "format": "pdf",
    "dpi": 600
  }'
```

## JavaScript

```javascript
const response = await fetch('https://scifig.ai/api/v1/images/conversions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCIFIG_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    Prefer: 'wait=25',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "image": "<file_id>",
    "format": "pdf",
    "dpi": 600
  }),
});
const result = await response.json();
console.log(response.status, result);
```

## Python

```python
import os
import uuid

import requests

headers = {
    "Authorization": f"Bearer {os.environ['SCIFIG_API_KEY']}",
    "Idempotency-Key": str(uuid.uuid4()),
    "Prefer": "wait=25",
}
response = requests.post(
    "https://scifig.ai/api/v1/images/conversions",
    headers=headers,
    json={
        "image": "<file_id>",
        "format": "pdf",
        "dpi": 600
    },
    timeout=60,
)
print(response.status_code, response.json())
```