图片生成API

本文将介绍慧星云生图模型 API 接口的使用。

POST /api.huixingyun.com/v1/images/generations

使用 Bearer token 方式进行 API 鉴权，格式为 Bearer 加上 API Key。

Curl 请求中 HTTP Auth 头示例：--header 'Authorization: Bearer sk-xxxxxxxxxxxxxx' \

Body

名称	类型	是否必填	说明
model	string	是	模型id
prompt	string	是	生成图片的描述。 Seedream：不超过300个汉字或600个英文单词。
negative_prompt	string		反向提示词，描述不希望画面中生成的内容。Seedream不支持。
size	string		生成图片的尺寸。默认值：`2048x2048`；总像素取值范围[`1280x720`,`4096x4096`]；宽高比取值范围：[1/16, 16]。
n	integer		生成图片数量。Seedream不支持指定数量，设置该参数意味着最多可生成的图片数量
seed	integer		随机数种子。Seedream不支持。
num_inference_steps	integer		采样步数。Seedream不支持。
guidance_scale	number		指导密度值，较高的值会使得生成的图像更忠于文本提示，但可能减少多样性；较低的值则允许更多创造性，增加图像变化。Seedream不支持。
image	string		传入的参考图片，支持 URL 或 Base64 编码。`图片URL`：请确保图片URL可被访问。`Base64编码`：请遵循此格式data:image/<图片格式>;base64,<Base64编码>。注意 <图片格式> 需小写，如 data:image/png;base64,<base64_image>。传入图片需要满足以下条件：图片格式：jpeg、png；宽高比（宽/高）范围：[1/3, 3] ；宽高长度（px） > 14；大小：不超过 10MB；总像素：不超过 6000×6000 px； doubao-seedream-4.0 最多支持传入 10 张参考图。
stream	Boolean		是否以流式接口的形式返回数据。`false`（默认）：非流式输出模式，等待所有图片全部生成结束后再一次性返回所有信息。`true`：流式输出模式，即时返回每张图片输出的结果。在生成单图和组图的场景下，流式输出模式均生效。
response_format	string		指定生成图片的返回格式。生成的图片为 jpeg 格式，支持以下两种返回方式：`url`（默认）：返回图片下载链接；链接在图片生成后24小时内有效，请及时下载图片。`b64_json`：以 Base64 编码字符串的 JSON 格式返回图像数据。
sequential_image_generation	string		控制是否关闭组图功能。（组图：基于您输入的内容，生成的一组内容关联的图片。）`disabled`（默认）：关闭组图功能，模型只会生成一张图。`auto`：自动判断模式，模型会根据用户提供的提示词自主判断是否返回组图以及组图包含的图片数量。仅Seedream支持该参数设置。

Body

名称	类型	说明
created	integer	本次请求创建时间的 Unix 时间戳（秒）。
data	object	输出图片的信息。
data.url	string	图片的 url 信息，当 response_format 指定为`url`时返回。该链接将在生成后 24 小时内失效，请务必及时保存图像。
data.b64_json	string	图片的 base64 信息，当 response_format 指定为 `b64_json`时返回。
output_format	string	输出图片格式。
size	string	输出图片尺寸。
usage	object	本次请求的用量信息。
usage.input_tokens	integer	输入的 Token 总数。
usage.output_tokens	integer	输出的 Token 总数。
usage.total_tokens	integer	本次请求的 Token 总数（含请求和响应）。
usage.input_tokens_details	object	输入的 Token 详情。
usage.input_tokens_details.image_tokens	integer	输入图片内容花费的 token 数
usage.input_tokens_details.text_tokens	integer	输入文本内容花费的 token 数

curl -X POST https://api.huixingyun.com/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "帮我生成一张日照金山的风景图",
    "n":1,
    "size": "2496x1664",
    "sequential_image_generation": "disabled",
    "stream": false,
    "response_format": "url"
}'

{
    "created": 1763026825,
    "data": [
        {
            "url": "https://……"
        }
    ],
    "output_format": "jpeg",
    "size": "2496x1664",
    "usage": {
        "input_tokens": 0,
        "output_tokens": 20000,
        "total_tokens": 20000,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 0
        }
    }
}

curl -X POST https://api.huixingyun.com/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "生成冬天女孩在公园里的画面",
    "n":1,
    "image": "http://hxy-model.test.upcdn.net/sample.jpeg",
    "size": "2048x2048",
    "sequential_image_generation": "disabled"
}'

{
    "created": 1763453239,
    "data": [
        {
            "url": "https://……"
        }
    ],
    "output_format": "jpeg",
    "size": "2048x2048",
    "usage": {
        "input_tokens": 0,
        "output_tokens": 20000,
        "total_tokens": 20000,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 0
        }
    }
}

curl -X POST https://api.huixingyun.com/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "生成3张女孩和奶牛玩偶在游乐园开心地坐过山车的图片，涵盖早晨、中午、晚上",
    "n":3,
    "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png", 
                "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png"],
    "size": "2496x1664",   
    "sequential_image_generation": "auto"
}'

{
    "created": 1763454221,
    "data": [
        {
            "url": "https://……"
        },
        {
            "url": "https://……"
        },
        {
            "url": "https://……"
        }
    ],
    "output_format": "jpeg",
    "size": "2496x1664",
    "usage": {
        "input_tokens": 0,
        "output_tokens": 60000,
        "total_tokens": 60000,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 0
        }
    }
}

curl -X POST https://api.huixingyun.com/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "参考这个LOGO，做一套户外运动品牌视觉设计，品牌名称为GREEN，包括包装袋、帽子、纸盒、手环、挂绳等。绿色视觉主色调，趣味、简约现代风格",
    "n":3,
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimages.png",
    "sequential_image_generation": "auto",
    "size": "2048x2048",
    "stream": true
}'

data: [DONE]
data: {
  "type": "image_generation.completed",
  "url": "https://...",
  "created_at": 1757396757,
  "size": "2496x1664",
  "output_format": "jpeg",
  "usage": {
        "image_count": 3,
        "input_tokens": 0,
        "output_tokens": 60000,
        "total_tokens": 60000,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 0
   }
}

data: {
  "type": "image_generation.partial_image",
  "url": "https://...",
  "created_at": 1757396757,
  "size": "2496x1664",
  "output_format": "jpeg",
  "partial_image_index": 1
}

data: {
  "type": "image_generation.partial_image",
  "url": "https://...",
  "created_at": 1757396757,
  "size": "2496x1664",
  "output_format": "jpeg",
  "partial_image_index": 0
}

2025-11-19

图片生成API

鉴权

请求

响应

调用示例

文生图

图生图

多参考图生组图

流式输出

本页目录