概要

SciDraw AI の REST API は、画像生成・画像編集・形式変換のための安定したジョブ制 エンドポイントを提供します。

ベース URL： https://sci-draw.com

機械可読な仕様： OpenAPI JSON · OpenAPI YAML

この 2 つのファイルは、同じ API を OpenAPI 形式で記述したものです。どちらかを Postman や Insomnia に読み込めば全エンドポイントとパラメータが自動で埋まり、 コードジェネレーターに渡せば型付きクライアントを生成でき、AI エージェントに 渡せばリクエストを手書きしなくても API を呼び出せます。2 つの形式は内容が同じ なので、お使いのツールが受け付けるほうを選んでください。

クイックスタート

1. 設定 → API キー でキーを作成し、統合に必要な スコープだけを選びます。
2. キーは Authorization: Bearer sd_... として送信します。
3. すべての作成リクエストに一意の Idempotency-Key を付けます。
4. 返ってきたジョブ ID を保存し、Location の URL を succeeded・failed・ canceled のいずれかになるまでポーリングします。

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

作成リクエストは通常 202 Accepted、ジョブオブジェクト、Location ヘッダー、 Retry-After: 2 を返します。Prefer: wait=10 を付ければ最大 10 秒まで待機でき ます。待機してもジョブの動作自体は変わりません。返却ステータスがすでに終了して いるジョブの場合のみ 200 になり、それ以外は 202 のままです。

エンドポイント

すべてのレスポンスは JSON のエンベロープです。どのレスポンスにも X-Request-Id が含まれるので、サポートに問い合わせる際はその ID を添えて ください。返却されるファイル参照は、出力 URL と公開ファイル ID のみです。 能力のルーティングは SciDraw AI が管理します。