Seedream 画像生成 - CometAPI Documentation

POST

images

generations

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "a cat wearing a scarf sitting by the window watching rain, illustration style",
    "size": "2K",
    "response_format": "url",
    "watermark": false
  }' | jq -r '.data[].url'

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ],
  "usage": {
    "generated_images": 123,
    "output_tokens": 123,
    "total_tokens": 123
  },
  "model": "<string>"
}

概要

標準の OpenAI 互換 /v1/images/generations エンドポイントを通じて、ByteDance の Seedream モデルを使用して画像を生成します。text-to-image と image-to-image の両方の生成に対応しています。完全なモデル一覧については、Models page を参照してください。プロバイダーによる詳細なパラメータドキュメントについては、VolcEngine documentation を参照してください。

連続（マルチ画像）生成を使用する場合は、sequential_image_generation を auto に設定し、必要に応じて sequential_image_generation_options.max_images を設定して出力画像数を制限してください。参照画像と生成画像の合計数は 15 以下 である必要があります。

画像から画像生成

テキストプロンプトとあわせて、image パラメータ（URL または base64 data URI の配列）で 1 枚以上の参照画像を渡します。最大 14 枚の参照画像をサポートしています。

返された URL で AccessDenied になりますか？

返される url は、& やその他の特殊文字を含む署名付きオブジェクトストレージリンクです。
生の JSON をコピーしてそのままブラウザやスクリプトに貼り付けると、シェルでのエスケープやターミナルでの切り詰めによって署名パラメータが失われ、次のようになることがあります。

\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}

修正方法:

curl: | jq -r '.data[].url' を使って URL を正しく抽出してください。
Python: result.data[0].url または image["url"] を使用してください。文字列はすでに完全な状態なので、そのまま requests.get() や webbrowser.open() に渡せます。
JavaScript: 同様に result.data[0].url を使用します。
一般: URL 内の & と % が切り詰められたり二重にエスケープされたりしていないことを確認してください。

承認

Authorization

string

header

必須

Bearer token authentication. Use your CometAPI key.

ボディ

application/json

Parameters for Seedream image generation (text-to-image and image-to-image).

model

string

デフォルト:doubao-seedream-5-0-260128

必須

Model to use. See the Models page for current Seedream model IDs.

prompt

string

デフォルト:a cat wearing a scarf sitting by the window

必須

Text prompt describing the image to generate. Supports both Chinese and English. Recommended max 300 Chinese characters or 1000 English characters.

response_format

enum<string>

デフォルト:url

Output format. url returns a temporary image link (valid for 24 hours); b64_json returns base64-encoded image data.

利用可能なオプション:

url,

b64_json

size

string

デフォルト:2048x2048

Output resolution. Presets 2K, 4K, or exact pixels like 2048x2048, 2304x1728, 2848x1600, 1600x2848, etc. Default: 2048x2048.

image

string[]

Reference image(s) for image-to-image generation. Each item is a public URL or base64 data URI (data:image/png;base64,...). Supports up to 14 reference images. Supported formats: jpeg, png, webp, bmp, tiff, gif.

watermark

boolean

デフォルト:true

When true, adds an 'AI Generated' watermark to the bottom-right corner of the output image.

guidance_scale

number

デフォルト:2.5

Controls how closely the output follows the prompt. Higher values increase adherence but may reduce naturalness. Range: 1.0–10.0. Not supported by Seedream 5.0 (ignored).

seed

integer

デフォルト:-1

Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation. Legacy parameter — ignored by newer models.

sequential_image_generation

enum<string>

デフォルト:disabled

Controls sequential (multi-image) generation mode.

auto: model decides whether to generate a sequence based on the prompt
disabled: always generate a single image

利用可能なオプション:

auto,

disabled

sequential_image_generation_options

object

Configuration for sequential (multi-image) generation. Only effective when sequential_image_generation is auto.

Show child attributes

output_format

enum<string>

デフォルト:jpeg

Output image file format. Options: png, jpeg.

利用可能なオプション:

png,

jpeg

レスポンス

200 - application/json

Successful Response

created

integer

必須

Unix timestamp (seconds) when the image was generated.

data

object[]

必須

Array of generated image objects.

Show child attributes

usage

object

必須

Resource usage information for this request.

Show child attributes

model

string

The model used for generation.

Replicate ステータス照会

SeedEdit 画像編集

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "a cat wearing a scarf sitting by the window watching rain, illustration style",
    "size": "2K",
    "response_format": "url",
    "watermark": false
  }' | jq -r '.data[].url'

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ],
  "usage": {
    "generated_images": 123,
    "output_tokens": 123,
    "total_tokens": 123
  },
  "model": "<string>"
}

Documentation Index

​概要

​画像から画像生成

​返された URL で AccessDenied になりますか？

承認

ボディ

レスポンス

概要

画像から画像生成

返された URL で AccessDenied になりますか？