画像生成

POST /api/v1/images/generations は、テキストの説明から 1〜4 枚の画像を生成します。必要なスコープ：images:generate。

JSON ボディ

フィールド	型	必須	既定値	制約
`prompt`	string	はい	—	前後の空白を除いて 5〜2,000 文字
`aspect_ratio`	string	いいえ	`1:1`	`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`5:4`、`4:5`、`21:9`
`resolution`	string	いいえ	`2K`	`2K` または `4K`
`count`	integer	いいえ	`1`	1〜4

未知のフィールドは拒否されます。公開リクエストに能力ルーティングの指定項目はありません。

クレジット

解像度	1 枚あたりのクレジット
`2K`	5
`4K`	20

確保される総量は、1 枚あたりのコストに count を掛けた値です。クレジットはジョブが受理された時点でアトミックに確保され、成功時に確定し、終了状態の失敗時に解放されます。

cURL

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: manuscript-42-panel-a' \
  -H 'Prefer: wait=10' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"A labeled plant cell diagram","aspect_ratio":"4:3","resolution":"2K","count":1}'

JavaScript

const response = await fetch('https://sci-draw.com/api/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCIDRAW_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json'

Python

import os, uuid, requests

response = requests.post(
    "https://sci-draw.com/api/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['SCIDRAW_API_KEY']}"

キューまたは処理中は 202 を、待機時間内に終了状態へ達した場合は 200 を返します。レスポンスのスキーマとポーリングの流れはジョブを参照してください。

JSON ボディ

クレジット

cURL

JavaScript

Python

目次