Generations（SeedEdit 3.0）

正式环境

https://api.302.ai

POST

/doubao/images/generations

即梦新出的API格式，采用了OpenAI兼容的图像生成格式，并发数量更高
仅支持模型：
doubao-seedream-3-0-t2i-250415
doubao-seededit-3-0-i2i-250628

价格：0.05 PTC/张

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

响应参数说明

字段列表

字段名	类型	说明
model	string	本次请求使用的模型 ID（模型名称-版本）。
created	integer	本次请求创建时的 Unix 时间戳（秒）。
data	list	输出图片的信息，包括图片下载的 URL 或 Base64。 - 当指定返回格式为 url 时，字段为 `url` - 当指定返回格式为 b64_json 时，字段为 `b64_json` 注意：为确保信息安全，url 链接将在生成后 24 小时内失效，请务必及时保存图片。
usage	object	图片生成相关信息。 - `usage.generated_images`（integer）：模型生成的图片张数。
error	object	错误信息（可选）。 - `error.code`（string）：错误码 - `error.message`（string）：错误提示信息

data 字段说明

当 response_format 为 url 时，data 数组的每个元素包含字段：

url：图片下载地址

当 response_format 为 b64_json 时，data 数组的每个元素包含字段：

b64_json：图片的 Base64 编码字符串

usage 字段说明

usage.generated_images：模型生成的图片张数（integer）

error 字段说明（可选）

error.code：错误码（string）

error.message：错误提示信息（string）

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.302.ai/doubao/images/generations' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seededit-3-0-i2i-250628",
    "prompt": "改成爱心形状的泡泡",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream_i2i.jpeg",
    "response_format": "url",
    "size": "adaptive",
    "seed": 21,
    "guidance_scale": 5.5,
    "watermark": false
}'

响应示例

{
    "model": "doubao-seedream-3-0-t2i-250415",
    "created": 1749720737,
    "data": [
        {
            "url": "https://file.302.ai/gpt/imgs/1788db737a9b475c0f30aeca66a26af6.jpg"
        }
    ],
    "usage": {
        "generated_images": 1
    }
}

修改于 2025-07-21 09:36:49

Generations（Seedream 3.0）

Drawing（即梦图片生成）