カスタム AWS S3 バケットの設定 - Documentation

デフォルトでは、Novita AI は出力結果を当社のプライベート S3 バケットに一時的に保存し、一時的に認可された S3 リンクを通じてユーザーに結果を返します。ただし、カスタム S3 バケットを設定することで、結果をお客様自身のバケットに保存できるようにできます。これを有効にするには、以下の手順に従ってください。

1. S3 バケットポリシーを設定する

まず、S3 バケットポリシーの設定を次の形式に変更します（${BucketName} をお客様のバケット名に置き換えてください）。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "CanonicalUser": "e98cde8d11ec7c03ac08688f1a933b08b0f0f7746b21c4f2e7b2c8202cc0532f"
      },
      "Action": [
        "s3:PutObject",
        "s3:PutObjectAcl"
      ],
      "Resource": "arn:aws:s3:::${BucketName}/*"
    }
  ]
}

2. V3 API でカスタムストレージを有効にする

V3 API エンドポイントでは、Novita AI はリクエストボディ内で custom_storage パラメータを提供しており、生成された画像を保存するためのカスタム S3 バケットを設定できます。以下は、txt2img API エンドポイントを使用した例です。

curl --location 'https://api.novita.ai/v3/async/txt2img' \
--header 'Authorization: Bearer {{API Key}}' \
--header 'Content-Type: application/json' \
--data '{
  "extra": {
    "response_image_type": "jpeg",
    "custom_storage": {
      "aws_s3": {
        "region": "us-east-2",
        "bucket": "test_bucket",
        "path": "/"
      }
    }
  },
  "request": {
    "prompt": "a cute dog",
    "model_name": "realisticVisionV51_v51VAE_94301.safetensors",
    "negative_prompt": "",
    "width": 512,
    "height": 384,
    "image_num": 2,
    "steps": 20,
    "seed": 123,
    "clip_skip": 1,
    "sampler_name": "Euler a",
    "guidance_scale": 7.5
  }
}'

最終更新日 2026年5月15日