方舟官方产物验证 API
火山方舟(火山引擎)上传图片或视频产物,通过官方 API 查询其是否由方舟平台生成及对应模型版本。
调用 Seedream 系列模型,通过提示词与参考图生成图像、组图、RGBA 透明图或进行图层拆分。
火山方舟图片生成 API 是面向开发者的 HTTP 接口(POST https://ark.cn-beijing.volces.com/api/v3/images/generations),支持 Seedream 5.5、5.0 pro/flash/lite、4.5/4.0 等模型。输入为文本提示词(中英文,另有附加语言)加可选参考图,输出为图片 URL 或 Base64 数据。核心能力包括文生图、单图/多图生图、组图生成、原生 RGBA 透明图、图层拆分(返回 z_index、bounding_box、富文本 OCR)以及 Seedream 5.0 lite 的联网搜索工具。限制包括参考图数量与大小上限、分层各模型的分辨率区间差异,以及 url 返回链接 24 小时有效。
能力差异按模型划分:Seedream 5.5 图层拆分最多输出 1 张底图加 99 个图层,支持富文本 OCR(字体、颜色、粗体、斜体、下划线、删除线、阴影、半透明)与文生 RGBA;5.0 pro/flash 拆分上限 16 个图层,RGBA 生图最多 10 张参考图且输入图必须自带透明通道,文生 RGBA 不支持。5.0 lite/4.5/4.0 支持组图(sequential_image_generation=auto,参考图+生成图合计≤15 张)与流式输出,暂不支持组图生成、联网搜索、流式输出的模型为 5.5/5.0 pro/flash。图层拆分仅支持单张输入图(png/jpeg,512×512 以上、≤30MB),任一图层失败整体报错;图层始终以 png 输出,output_format 仅控制底图。尺寸参数 size 有两种配置方式且不可混用:分辨率档位(1K/1.5K/2K 等)或指定宽高像素值,需同时满足各模型的总像素与宽高比区间。提示词建议中文不超过 300 字、英文不超过 600 词。响应中 usage 按成功生成张数计费(output_tokens=sum(宽×高)/256 取整)。
需要在应用中集成图像生成能力的开发者,以及需要批量生产素材、拆分设计图层或提取文字样式的设计与内容团队;接口需具备 API 调用与鉴权配置经验。
开通火山方舟模型服务并在 API Key 管理页面获取长效 API Key,查询所需模型的 Model ID(或创建 Endpoint ID 获得限流、监控等高级能力)。
按 POST https://ark.cn-beijing.volces.com/api/v3/images/generations 构造请求,设置 model 与 prompt,必要时通过 image 传入参考图(URL 或 Base64)。
按模型能力配置可选参数:图层拆分用 layer_decomposition 与 layer_decomposition_options,组图用 sequential_image_generation 及 max_images,透明图用 background,尺寸用 size,返回格式用 response_format(url 或 b64_json)。
发送请求并解析 data 数组;url 返回的链接 24 小时内有效,需及时下载,官方建议配置 TOS 数据订阅长期备份。
通过 usage 字段核对成功生成张数与 token 消耗;组图场景单张失败时读取 data.error 排查,整体失败读取顶层 error。
需火山方舟账号并开通模型服务,鉴权使用 API Key(Bearer)。url 返回链接生成后 24 小时内有效。发起调试等同真实调用,可能产生云产品费用。seedream 5.0 lite 联网搜索会增加时延。具体价格、地区可用性需查官网。
费用与套餐:来源提到计费类型(前付费/后付费)、按张数计费与 IPM 预扣减额度,但未给出具体单价,实际价格需以火山方舟官网为准。