火山图片生成（官方兼容） - 问高云API开发文档

curl --request POST \
  --url https://xxx.wengaocloud.com/volcengine/v3/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5-0-lite-260128",
  "prompt": "一朵七色花，通透花瓣，纯色背景，质感细腻"
}
'

{
  "created": 1779860032,
  "data": [
    {
      "url": "https://cdn.wengaocloud.com/images/ai/example.png",
      "size": "1024x1024"
    }
  ],
  "usage": {
    "input_tokens": 320,
    "output_tokens": 512,
    "total_tokens": 832
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

curl --request POST \
  --url https://xxx.wengaocloud.com/volcengine/v3/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5-0-lite-260128",
  "prompt": "一朵七色花，通透花瓣，纯色背景，质感细腻"
}
'

{
  "created": 1779860032,
  "data": [
    {
      "url": "https://cdn.wengaocloud.com/images/ai/example.png",
      "size": "1024x1024"
    }
  ],
  "usage": {
    "input_tokens": 320,
    "output_tokens": 512,
    "total_tokens": 832
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

授权

Authorization

string

header

默认值:sk-your-api-key

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

该接口保持火山官方字段语义，不接受 OpenAI 风格的 n。如果需要组图，请使用 sequential_image_generation 和 sequential_image_generation_options.max_images。

model

string

必填

要调用的模型名称。

示例:

"doubao-seedream-5-0-lite-260128"

prompt

string

必填

火山官方提示词字段，必填。

image

参考图 URL 或 Base64 数据。输入图与输出图分开计费。

size

string

目标输出尺寸，例如 1024x1024、2048x2048。

示例:

"1024x1024"

seed

integer

随机种子。

guidance_scale

number

提示词引导强度。

response_format

enum<string>

返回图片内容的格式。

可用选项:

url,

b64_json

output_format

enum<string>

输出图片格式。

可用选项:

jpeg,

png,

webp

watermark

boolean

是否要求带水印输出。

sequential_image_generation

string

顺序组图模式，当前常见值为 auto。

示例:

"auto"

sequential_image_generation_options

object

Hide child attributes

sequential_image_generation_options.max_images

integer

顺序组图最大张数。

必填范围: x >= 1

stream

boolean

是否请求 SSE。模型未开通流式会返回 400。

tools

object[]

工具数组，是否支持取决于具体模型。

optimize_prompt_options

object

火山官方提示词优化配置。

Hide child attributes

optimize_prompt_options.mode

string

示例:

"standard"

响应

同步模式返回 JSON 结果；当请求 stream=true 且模型支持流式时，返回 text/event-stream。

created

integer

响应创建时间，Unix 秒。

data

object[]

Hide child attributes

data.url

string<uri>

结果图 URL。response_format=url 时常见。

data.b64_json

string

Base64 图片数据。response_format=b64_json 时常见。

data.size

string

上游返回的实际图片尺寸，用于最终逐张结算。

示例:

"1024x1024"

data.revised_prompt

string

平台透传的最终提示词。

usage

object

平台透传的上游 usage 字段。