火山方舟大模型服务平台

产品简介

快速入门-调用模型服务

快速入门-速览平台功能

模型介绍

模型列表

API 参考

获取 API Key 并配置

安装及升级 SDK

对话(Chat)-文本 API

POST

视频生成 API

图片生成 API

POST

向量化 API

图片生成 API开发中

POSThttps://ark.cn-beijing.volces.com/api/v3/images/generations

创建时间: 2025-05-31 21:33

请求参数

Header 参数

参数名	示例值	是否必填	参数类型	描述说明
Content-Type	application/json	是	string	-
Authorization	Bearer {{ARK_API_KEY}}	是	string	-

Body 参数application/json

数据结构

promptstring

可选

用于生成图像的提示词。

modelstring

可选

本次请求使用模型的 Model ID 或推理接入点 (Endpoint ID)，目前仅支持 doubao-seedream-3-0-t2i-250415。

response_formatstring

可选

指定生成图像的返回格式。支持以下两种取值： "url"：以可下载的 JPEG 图片链接形式返回； "b64_json"：以 Base64 编码字符串的 JSON 格式返回图像数据。

sizestring

可选

生成图像的宽高像素，要求介于 [512 x 512, 2048 x 2048] 之间。推荐可选的宽高： 1024x1024 （1:1） 864x1152 （3:4） 1152x864 （4:3） 1280x720 （16:9） 720x1280 （9:16） 832x1248 （2:3） 1248x832 （3:2） 1512x648 （21:9）

seedstring

可选

随机数种子，用于控制模型生成内容的随机性。取值范围为 [-1, 2147483647]。如果不提供，则算法自动生成一个随机数作为种子。如果希望生成内容保持一致，可以使用相同的 seed 参数值。

guidance_scalenumber

可选

模型输出结果与prompt的一致程度，即生成图像的自由度；值越大，模型自由度越小，与用户输入的提示词相关性越强。取值范围：[1, 10] 之间的浮点数。

watermarkboolean

可选

是否在生成的图片中添加水印。 false：不添加水印。 true：在图片右下角添加“AI生成”字样的水印标识。

示例数据

{
  "model": "doubao-seedream-3-0-t2i-250415",
  "prompt": "鱼眼镜头，一只猫咪的头部，画面呈现出猫咪的五官因为拍摄方式扭曲的效果。",
  "response_format": "url",
  "size": "1024x1024",
  "seed": 12,
  "guidance_scale": 2.5,
  "watermark": true
}

响应示例

成功

HTTP状态码：200

内容格式：JSON

数据结构

modelstring

可选

本次请求使用的模型 ID （模型名称-版本）。

createdstring

可选

本次请求创建时间的 Unix 时间戳（秒）。

datastring

可选

输出图像的信息，包括图像下载的 URL 或 Base64。当指定返回生成图像的格式为url时，则相应参数的子字段为url；注意：为确保信息安全，该链接将在生成后 24 小时内失效，请务必及时保存图像。当指定返回生成图像的格式为b64_json时，则相应参数的子字段为b64_json。

usageobject

可选

generated_imagesstring

可选

模型生成的图片张数。

errorobject

可选

codestring

可选

错误码

messagestring

可选

错误提示信息

响应示例

{
    "model": "doubao-seedream-3-0-t2i-250415"
  "created": 1589478378,
    "data": [
        {
            "url": "https://..."
        }
    ],
    "usage": {
        "generated_images": 1
    }
}

最后更新: 3 周前

POST取消或删除视频生成任务

POST文本向量化 API