# SciFig API

HTTP 経由で科学図表、グラフ、フローチャートを作成できます。エンジン、料金、クレジットは SciFig のウェブサイトと共通です。

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

## クイックスタート

- [設定 → 開発者](/ja/app/settings?tab=developer)で API キーを作成します。生成用キーには有効なサブスクリプション、または残高が 0 を超えるクレジットパックが必要です。読み取り専用キーはどのアカウントでも使えます。
- `Idempotency-Key` を付けて作成リクエストを送信します。`Prefer: wait=25` を指定すると最大 25 秒待機し、その間に完了すれば完了済みのジョブを返します。
- ジョブがまだ `queued` または `processing` の場合は、`Retry-After` に従って数秒ごとに `GET /jobs/{id}` を読み取り、`succeeded` または `failed` になるまで確認します。
- 各出力の `download_url`（有効期間 1 時間）からダウンロードするか、`file_id` を別のエンドポイントに渡します。

```bash
curl -X POST https://scifig.ai/api/v1/images/generations \
  -H "Authorization: Bearer $SCIFIG_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=25" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Mitochondrial electron transport chain, labelled", "aspect_ratio": "4:3"}'
```

ベース URL：`https://scifig.ai/api/v1`。機械可読の仕様：[OpenAPI JSON](https://scifig.ai/api/v1/openapi.json) と [OpenAPI YAML](https://scifig.ai/api/v1/openapi.yaml)。AI アシスタントは [MCP サーバー](/ja/mcp)から同じ機能を利用できます。

## エンドポイント

| エンドポイント | 機能 | クレジット |
| --- | --- | --- |
| POST /images/generations | プロンプトから科学図表を生成 | 50 / 75 / 100 |
| POST /images/edits | 指示や領域指定による編集、白背景、縦横比変更、配色変更、文字置換 | 50 / 75 / 100、領域指定または文字置換は 100 |
| POST /images/text-detections | 文字を置換する前に画像内の文字を検出 | 0 |
| POST /images/upscales | 2K、4K、8K に高解像度化 | 50 / 100 / 150 |
| POST /images/conversions | SVG ベクター化、PNG・PDF・TIFF・PPTX 書き出し | SVG は 150、PNG・PDF・TIFF・PPTX は無料 |
| POST /charts/generations | CSV、TSV、Excel データからグラフを作成 | 100 |
| POST /charts/edits | グラフの最新バージョンを変更 | 100 |
| POST /flowcharts/generations | SVG のフローチャートを作成 | 100 |
| POST /flowcharts/edits | フローチャートの最新バージョンを変更 | 100 |
| POST /files | 画像、マスク、添付ファイルをアップロード | 0 |
| GET /files/{file_id} | ファイルをダウンロード | 0 |
| GET /jobs/{id} | ジョブを 1 件取得 | 0 |
| GET /jobs | 最近のジョブを一覧表示 | 0 |
| GET /credits | 残高、プラン、タスクの制限 | 0 |
| GET /pricing | すべての料金（認証不要） | 0 |
| GET /openapi.json | OpenAPI 3.1 仕様（認証不要） | 0 |
| GET /openapi.yaml | 同じ仕様の YAML 版（認証不要） | 0 |

Webhook、SDK、コマンドラインツールは提供していません。サーバーやスクリプトからエンドポイントを直接呼び出してください（API はブラウザーからの CORS リクエストを許可していません）。