API リファレンス
SciFig API
HTTP 経由で科学図表、グラフ、フローチャートを作成できます。エンジン、料金、クレジットは SciFig のウェブサイトと共通です。
クイックスタート#
- 設定 → 開発者で API キーを作成します。生成用キーには有効なサブスクリプション、または残高が 0 を超えるクレジットパックが必要です。読み取り専用キーはどのアカウントでも使えます。
Idempotency-Keyを付けて作成リクエストを送信します。Prefer: wait=25を指定すると最大 25 秒待機し、その間に完了すれば完了済みのジョブを返します。- ジョブがまだ
queuedまたはprocessingの場合は、Retry-Afterに従って数秒ごとにGET /jobs/{id}を読み取り、succeededまたはfailedになるまで確認します。 - 各出力の
download_url(有効期間 1 時間)からダウンロードするか、file_idを別のエンドポイントに渡します。
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 と OpenAPI YAML。AI アシスタントは 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 リクエストを許可していません)。