Skip to Content

Seedream 5.5

Seedream 5.5, an image generation model by ByteDance.

bytedance/seedream-5.5ByteDanceimage

Overview

Seedream 5.5, an image generation model by ByteDance.

  • Model ID: bytedance/seedream-5.5
  • Maker: ByteDance
  • Type: image
  • Timeout: 600 s
  • Unified format: Supported
  • Endpoint: POST https://api.kerox.ai/v1/tasks

Pricing

TierOfficial / imageKerox / imageSavings
1K/1.5K$0.0200$0.016020%
2K$0.0350$0.028020%
  • Tiers: set by the pixel count (width × height) of each output image: up to 2,601,123 px is 1K/1.5K; anything larger is 2K.
  • Reference images: each reference image adds $0.0064 (official $0.0080).

Request example

Submit a task with the model's native parameters.

curl -X POST https://api.kerox.ai/v1/tasks \
  -H "Authorization: Bearer $KEROX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream-5.5",
  "input": {
    "prompt": "editorial portrait of a ceramicist in morning sunlight, 35mm film",
    "size": "2K"
  },
  "wait_seconds": 30
}'

Parameters

ParameterTypeDefaultValuesDescription
sizestring"2K"—Size
imagestring | string[]——Reference images
promptstring——Prompt
watermarkbooleanfalse—Watermark
backgroundstring"auto"auto, transparent, opaqueBackground
output_formatstring"png"png, jpegOutput format
safety_identifierstring——End-user ID
optimize_prompt_optionsobject{"mode":"standard"}—Prompt optimization

Polling and output

Poll GET /v1/tasks/{id} or receive a webhook when the task finishes. Output files expire at expires_at (7 days after completion), so download anything you want to keep. The other fields of the task object are in the tasks guide and the API reference.

curl https://api.kerox.ai/v1/tasks/task_01JD8X9B4Q2M7T8N3K5P6R1S0V \
  -H "Authorization: Bearer $KEROX_API_KEY"

Input schema (JSON)

The full JSON Schema, nested parameters included
{
  "type": "object",
  "allOf": [
    {
      "if": {
        "required": [
          "background"
        ],
        "properties": {
          "background": {
            "const": "transparent"
          }
        }
      },
      "then": {
        "properties": {
          "output_format": {
            "const": "png"
          }
        }
      }
    }
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "prompt"
  ],
  "properties": {
    "size": {
      "type": "string",
      "x-tier": "common",
      "default": "2K",
      "pattern": "^(1K|1\\.5K|2K|[1-9][0-9]*x[1-9][0-9]*)$",
      "x-label-en": "Size",
      "x-label-zh": "尺寸",
      "x-constraints": {
        "max_aspect": 16,
        "max_pixels": 4624220,
        "min_aspect": 0.0625,
        "min_pixels": 921600
      }
    },
    "image": {
      "oneOf": [
        {
          "type": "string",
          "pattern": "^(https://|data:image/)"
        },
        {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^(https://|data:image/)"
          },
          "maxItems": 10,
          "minItems": 1
        }
      ],
      "x-tier": "common",
      "x-label-en": "Reference images",
      "x-label-zh": "参考图"
    },
    "prompt": {
      "type": "string",
      "x-tier": "common",
      "pattern": "\\S",
      "minLength": 1,
      "x-label-en": "Prompt",
      "x-label-zh": "提示词"
    },
    "watermark": {
      "type": "boolean",
      "x-tier": "advanced",
      "default": false,
      "x-label-en": "Watermark",
      "x-label-zh": "水印"
    },
    "background": {
      "enum": [
        "auto",
        "transparent",
        "opaque"
      ],
      "type": "string",
      "x-tier": "common",
      "default": "auto",
      "x-label-en": "Background",
      "x-label-zh": "背景"
    },
    "output_format": {
      "enum": [
        "png",
        "jpeg"
      ],
      "type": "string",
      "x-tier": "advanced",
      "default": "png",
      "x-label-en": "Output format",
      "x-label-zh": "输出格式"
    },
    "safety_identifier": {
      "type": "string",
      "x-tier": "advanced",
      "pattern": "^[\\x20-\\x7e]+$",
      "maxLength": 64,
      "minLength": 1,
      "x-label-en": "End-user ID",
      "x-label-zh": "终端用户标识"
    },
    "optimize_prompt_options": {
      "type": "object",
      "x-tier": "advanced",
      "default": {
        "mode": "standard"
      },
      "properties": {
        "mode": {
          "enum": [
            "standard"
          ],
          "type": "string",
          "x-tier": "advanced",
          "default": "standard",
          "x-label-en": "Mode",
          "x-label-zh": "模式"
        }
      },
      "x-label-en": "Prompt optimization",
      "x-label-zh": "提示词优化",
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}