画像編集

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',
  headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
  body: form,
});

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/edits",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("figure.png", image, "image/png")},
        data={"prompt": "Move the legend below the diagram"},
    )

アップロードされた元画像はジョブの非公開入力であり、ジョブやログのレスポンスに返されることはありません。冪等な重複アップロードは破棄され、受理された元画像は終了状態の結果が出たあとに削除されます。

2K と 4K はサイズ区分であり、辺の長さが固定されるわけではありません。表は実際の出力ピクセル数です。非対応の比率はジョブ作成やクレジット確保前に HTTP 400（INVALID_REQUEST）を返します。編集で aspect_ratio を省略する場合、元画像の比率は 1:3〜3:1 で、指定区分の条件（4K は 600 万ピクセル以上）を満たす必要があります。それ以外は対応する出力比率を指定してください。

`aspect_ratio`	`2K`	`4K`
1:1	2048×2048	2880×2880
16:9	2560×1440	3840×2160
9:16	1440×2560	2160×3840
4:3	2304×1728	3264×2448
3:4	1728×2304	2448×3264
3:2	2496×1664	3504×2336
2:3	1664×2496	2336×3504
5:4	2240×1792	3200×2560
4:5	1792×2240	2560×3200
21:9	3136×1344	3808×1632

フォームフィールド

クレジット

cURL

JavaScript

Python

出力サイズ

目次