1. volc
梧柏API使用文档
WHBAI · 豆包 Volc
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • 豆包 Volc
    • 创建视频生成任务
      POST
    • 查询任务列表
      GET
    • 查询单个任务
      GET
    • 取消任务
      DELETE
  • Seedance 2.0 · api
    • v3
      • 创建视频生成任务 API(doubao-2.0)
      • doubao-2.0 查询视频生成任务列表
      • doubao-2.0 查询视频生成任务 API
  • volc
    • Seedream 5.0 Pro
      POST
  • 数据模型
    • VolcSampleRequest
    • VolcSampleResponse
    • PostApiV3ContentsGenerationsTasksRequest
    • GetApiV3ContentsGenerationsTasksIdResponse
    • NewApiError
  1. volc

Seedream 5.0 Pro

POST
/api/v3/images/generations

网站中的模型与调用示例#

Seedream 5.0 Pro#

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "guidance_scale": {
      "description": "与 prompt 的一致程度,范围 [1, 10]",
      "examples": [
        2.5
      ],
      "maximum": 10,
      "minimum": 1,
      "type": "number",
      "x-i18n": {
        "en-US": {
          "description": "How closely to follow the prompt; range [1, 10]"
        }
      }
    },
    "image": {
      "description": "参考图(官方字段)。单张 URL 字符串,或多张 URL 数组(交互编辑/图生图,最多约 10 张)",
      "oneOf": [
        {
          "examples": [
            "https://example.com/ref.png"
          ],
          "format": "uri",
          "type": "string"
        },
        {
          "examples": [
            [
              "https://example.com/ref1.png",
              "https://example.com/ref2.png"
            ]
          ],
          "items": {
            "format": "uri",
            "type": "string"
          },
          "maxItems": 10,
          "minItems": 1,
          "type": "array"
        }
      ],
      "x-i18n": {
        "en-US": {
          "description": "Reference (official). Single URL string or URL array (interactive edit / I2I, up to ~10)"
        }
      }
    },
    "images": {
      "description": "兼容字段;网关会归一到 image。与 image 二选一即可",
      "oneOf": [
        {
          "format": "uri",
          "type": "string"
        },
        {
          "items": {
            "format": "uri",
            "type": "string"
          },
          "maxItems": 10,
          "minItems": 1,
          "type": "array"
        }
      ],
      "x-i18n": {
        "en-US": {
          "description": "compat field; gateway normalizes to image. Use either this or image"
        }
      }
    },
    "model": {
      "description": "模型名称",
      "enum": [
        "doubao-seedream-5-0-pro-260628"
      ],
      "examples": [
        "doubao-seedream-5-0-pro-260628"
      ],
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Model name"
        }
      }
    },
    "n": {
      "default": 1,
      "description": "生成张数,Pro 通常为 1",
      "examples": [
        1
      ],
      "maximum": 1,
      "minimum": 1,
      "type": "integer",
      "x-i18n": {
        "en-US": {
          "description": "Number of images; Pro usually 1"
        }
      }
    },
    "optimize_prompt_options": {
      "description": "提示词优化配置",
      "properties": {
        "mode": {
          "description": "优化模式",
          "enum": [
            "standard",
            "fast"
          ],
          "examples": [
            "standard"
          ],
          "type": "string",
          "x-i18n": {
            "en-US": {
              "description": "optimized mode"
            }
          }
        }
      },
      "required": [
        "mode"
      ],
      "type": "object",
      "x-i18n": {
        "en-US": {
          "description": "prompt optimization settings"
        }
      }
    },
    "output_format": {
      "description": "图片文件格式",
      "enum": [
        "jpeg",
        "png"
      ],
      "examples": [
        "png"
      ],
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "image file format"
        }
      }
    },
    "prompt": {
      "description": "生成/编辑提示词",
      "examples": [
        "一只猫坐在窗边,阳光透过玻璃,写实摄影"
      ],
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "generation / edit prompt"
        }
      }
    },
    "response_format": {
      "description": "返回形态",
      "enum": [
        "url",
        "b64_json"
      ],
      "examples": [
        "url"
      ],
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "response shape"
        }
      }
    },
    "seed": {
      "default": -1,
      "description": "随机种子,范围 [-1, 2147483647],默认 -1",
      "examples": [
        -1
      ],
      "maximum": 2147483647,
      "minimum": -1,
      "type": "integer",
      "x-i18n": {
        "en-US": {
          "description": "Random seed, range [-1, 2147483647], default -1"
        }
      }
    },
    "size": {
      "description": "分辨率档或像素尺寸。常用 1K/2K;也支持如 1024x1024、2048x2048、2816x1584 等。空值按高档计费",
      "enum": [
        "1K",
        "2K",
        "1024x1024",
        "1152x864",
        "864x1152",
        "1424x800",
        "800x1424",
        "1248x832",
        "832x1248",
        "1568x672",
        "2048x2048",
        "2368x1776",
        "1776x2368",
        "2816x1584",
        "1584x2816",
        "2496x1664",
        "1664x2496",
        "3136x1344"
      ],
      "examples": [
        "2K"
      ],
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Resolution tier or pixels. Commonly 1K/2K; also e.g. 1024x1024, 2048x2048, 2816x1584. Empty billed at higher tier"
        }
      }
    },
    "watermark": {
      "description": "是否添加水印",
      "examples": [
        false
      ],
      "type": "boolean",
      "x-i18n": {
        "en-US": {
          "description": "Whether to add a watermark"
        }
      }
    }
  },
  "required": [
    "model",
    "prompt"
  ]
}

请求示例 · 示例#

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "一只猫",
  "response_format": "url",
  "size": "2K",
  "watermark": false
}

响应示例 · 成功示例#

{
  "created": 1753347123,
  "data": [
    {
      "url": "https://p3-bot-sign.byteimg.com/tos-cn-i-xxx/generated-image.png~tplv-xxx.jpeg?rk3s=xxx&x-expires=1753433523&x-signature=xxx"
    }
  ]
}

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "一只猫",
    "response_format": "url",
    "size": "2K",
    "watermark": false
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/v3/images/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "一只猫",
    "response_format": "url",
    "size": "2K",
    "watermark": false
}'

返回响应

🟢200成功
application/json
OK
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success",
    "data": {
        "task_id": "task_example_001"
    }
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:25
上一页
doubao-2.0 查询视频生成任务 API
下一页
VolcSampleRequest
Built with