API ドキュメント
画像編集
アップロードした画像を自然言語の指示で編集する
POST /api/v1/images/edits は multipart/form-data を受け付けます。必要な
スコープ:images:edit。
フォームフィールド
| フィールド | 型 | 必須 | 既定値 | 制約 |
|---|---|---|---|---|
image | file | はい | — | PNG・JPEG・WebP、最大 10 MiB かつデコード後 4,000 万ピクセルまで |
prompt | string | はい | — | 編集指示、5〜2,000 文字 |
aspect_ratio | string | いいえ | 元画像に依存 | 生成と同じ公開比率 |
resolution | string | いいえ | 2K | 2K または 4K |
count | integer | いいえ | 1 | 1〜4 |
ファイルシグネチャは、申告された MIME タイプとは独立に検証されます。不正・
サイズ超過・安全でない画像は 400 INVALID_REQUEST、または同じ公開コードを伴う
HTTP 413 を返します。
クレジット
| 解像度 | 出力 1 枚あたりのクレジット |
|---|---|
2K | 10 |
4K | 20 |
cURL
curl https://sci-draw.com/api/v1/images/edits \
-H 'Authorization: Bearer sd_YOUR_KEY' \
-H 'Idempotency-Key: revise-figure-7-v2' \
-F 'image=@figure.png;type=image/png' \
-F 'prompt=Move the legend below the diagram and increase label contrast' \
-F 'resolution=2K' \
-F 'count=1'JavaScript
const form = new FormData();
form.set('image', file);
form.set('prompt', 'Move the legend below the diagram');
const response = await fetch('https://sci-draw.com/api/v1/images/edits', {
method: 'POST',
Python
with open("figure.png", "rb") as image:
response = requests.post(
"https://sci-draw.com/api/v1/images/edits",
headers={"Authorization": f"Bearer
アップロードされた元画像はジョブの非公開入力であり、ジョブやログのレスポンスに 返されることはありません。冪等な重複アップロードは破棄され、受理された元画像は 終了状態の結果が出たあとに削除されます。

API ドキュメント