方舟官方产物验证 API
火山方舟(火山引擎)上传图片或视频产物,通过官方 API 查询其是否由方舟平台生成及对应模型版本。

通过 API 调用的文生图与图生图模型,支持交互编辑、图层拆分和 14 种语言的原生文字生成。
Doubao Seedream 5.0 pro 与 flash 是火山方舟平台上的图像生成模型,输入为提示词和可选参考图,输出 png/jpeg 格式的生成图片。两款模型均支持文生图、单张与多张图生图、通过框选/坐标/任意标记指定位置的交互编辑,以及将单张图片拆分为 1 张底图加最多 16 个带透明通道的独立图层。pro 定位画质更高,flash 定位速度更快、价格更低。该工具以 API 形式提供,调用方需准备 ARK_API_KEY,通过 curl、Python、Java、Go SDK 或 OpenAI 兼容接口传入 Model ID 使用。图片 URL 输出仅保留 24 小时,需及时保存。
两款模型的 Model ID 分别为 doubao-seedream-5-0-pro-260628 和 doubao-seedream-5-0-flash-260915,基础用法与其他 Seedream 模型一致,只需替换 model 参数。分辨率档位支持 1K、1.5K、2K,也可在总像素范围 [921600, 4624220] 与宽高比 [1/16, 16] 内指定宽高像素值。交互编辑支持两种形式:任意标记加自然语言定位,或通过 <point>/<bbox> 坐标标签精准定位。图层拆分通过 layer_decomposition=true 开启,仅支持单张输入图,响应返回底图(z_index=0)与各图层的 url、z_index、bounding_box(absolute/normalized)及名称描述,便于在设计工具或前端画布中还原、重组或单独编辑图层;编辑单个透明图层时可配置 background=transparent 且 output_format=png 保留透明背景。图片生成场景最多传入 10 张参考图(jpeg/png/webp/bmp/tiff/gif/heic/heif,单张不超过 30MB),图层拆分场景仅支持单张 png/jpeg 输入。pro 支持提示词优化的 standard 与 fast 两种模式,flash 仅标准模式。两模型 IPM 限流均为每分钟 500 张;图层拆分每次请求预扣减 17 IPM,生成后按实际数量返还。Java SDK 需 com.volcengine:ark-runtime 0.6.0 或更高版本。
需要在应用中集成图像生成与编辑能力的开发者;以及需要批量生成图片、做局部精准编辑或把设计图拆成可编辑图层的设计与运营团队。
在火山方舟控制台获取 ARK_API_KEY 并确认目标 Model ID(pro 为 doubao-seedream-5-0-pro-260628,flash 为 doubao-seedream-5-0-flash-260915)。
准备输入:文生图只需 prompt;图生图与交互编辑需附待编辑图片(URL 或 Base64)及含定位信息的 prompt;图层拆分需设置 layer_decomposition=true 并仅传入 1 张图片。
通过 curl 或 Python/Java/Go SDK 调用 https://ark.cn-beijing.volces.com/api/v3/images/generations 接口,配置 size、output_format、watermark 等参数。
解析响应:普通生成取 data 中的图片 URL 或 b64_json;图层拆分按 z_index 与 bounding_box 还原或重组图层。
及时下载并保存输出图片,图片 URL 仅保留 24 小时。
时延敏感场景可将 pro 的 optimize_prompt_options.mode 设为 fast,或改用 flash 模型。
调用需火山方舟账号及 ARK_API_KEY,接口地址为北京区域 ark.cn-beijing.volces.com。图片 URL 仅保留 24 小时;账号下同模型 IPM 限流 500 张/分钟;图层拆分每次请求预扣减 17 IPM。输入图片不超过 30MB,图层拆分仅支持单张 png/jpeg。页面未说明免费额度与计费标准,需查官网。
费用与套餐:来源提到 Seedream 5.0 flash 价格更低,但页面未给出具体套餐与计价数字,费用需以火山方舟官网为准。