讯飞星辰 图像生成 API 文档

各模型支持的参数

讯飞星辰模型（Qwen-Image / kolors）

Input 参数

参数名	类型	必填	说明	取值范围/格式
prompt	string	是	文本内容，图片生成指令	非空字符串，不得超过 1000 个字符
negative_prompt	string	否	负面提示词，在进行文本生成时，可以提供一些负面或反向的示例，以帮助模型生成更符合期望的输出	字符串，不得超过 1000 个字符

ExtraBody 参数

参数名	类型	必填	说明	默认值	取值范围/格式
width	integer	否	图片的宽度	512	参考下方分辨率说明，不同的分辨率计费不同，请选择合适的使用。支持的分辨率组合：512x512, 640x360, 640x480, 640x640, 680x512, 512x680, 768x768, 720x1280, 1280x720, 1024x1024
height	integer	否	图片的高度	512	参考下方分辨率说明，不同的分辨率计费不同，请选择合适的使用。支持的分辨率组合：512x512, 640x360, 640x480, 640x640, 680x512, 512x680, 768x768, 720x1280, 1280x720, 1024x1024
seed	integer	否	产生图片的随机种子	-	范围：0 ~ INT_MAX
num_inference_steps	integer	否	产生图片的步长数	20	范围：0 ~ 50
guidance_scale	float	否	提示词相关度，越大越相关	5.0	范围：0 ~ 20.0
scheduler	string	否	调度器	DPM++ 2M Karras	枚举值：DPM++ 2M Karras, DPM++ SDE Karras, DDIM, Euler a, Euler
provider	object	否	调度配置参数	-	对象类型，包含图像生成特有参数和供应商调度参数。 图像生成特有参数： - enable_image_base64 (bool, 默认 false): 是否在响应数据的 data 字段中同时返回图像的 Base64 编码 - enable_image_origin_data (bool, 默认 false): 是否在响应中包含原始响应数据 供应商调度参数：还支持 only、order、sort、input_price_range、output_price_range、throughput_range、latency_range、input_length_range、allow_filter_prompt_length、ignore、allow_fallbacks 等参数。 详细说明请参考：供应商调度参数说明

分辨率说明

注：图片生成按点数计费，不同分辨率计费不同，具体如下：

分辨率（width × height）	图点数
512×512	6
640×360	6
640×480	6
640×640	7
680×512	7
512×680	7
768×768	8
720×1280	12
1280×720	12
1024×1024	14

请求示例

{
  "model": "Qwen-Image",
  "input": {
    "prompt": "a beautiful sunset over the ocean with vibrant colors",
    "negative_prompt": "low quality, blurry, distorted"
  },
  "extra_body": {
    "provider": {
      "enable_image_base64": false,
      "enable_image_origin_data": true
    },
    "width": 1024,
    "height": 1024,
    "seed": 12345,
    "num_inference_steps": 30,
    "guidance_scale": 7.5,
    "scheduler": "DPM++ 2M Karras"
  }
}

---

响应示例

所有模型都返回标准化的响应格式，示例如下：

{
  "created": 1736123456,
  "data": [
    {
      "url": "https://example.com/generated-image-1.jpg",
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."  // 可选字段
    },
    {
      "url": "https://example.com/generated-image-2.jpg"
    }
  ],
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0
    },
    "image_count": 1
  },
  "provider": "讯飞星辰",
  "model": "Qwen-Image",
  "origin_data": { ... }  // 可选字段
}

说明：

• data[].b64_json 字段：仅在 extra_body.provider.enable_image_base64 设置为 true 时返回。默认值为 false，此时响应中不包含 b64_json 字段
• origin_data 字段：包含供应商 API 的完整原始响应数据。可通过设置 extra_body.provider.enable_image_origin_data 参数控制是否返回此字段（默认值为 false，不会返回）。如需查看不同模型的原始响应格式，请在请求中设置 extra_body.provider.enable_image_origin_data: true，然后在响应的 origin_data 字段中查看供应商返回的原始数据

响应参数说明

成功响应

参数名	类型	必填	说明	取值范围/格式
created	integer	是	响应创建时间，Unix 时间戳（秒）	整数，Unix 时间戳（秒）
data	array	是	生成的图像数据数组	数组对象，每个元素包含图像信息
data[].url	string	是	生成的图像 URL	URL 字符串
data[].b64_json	string	否	图像的 Base64 编码数据。控制参数：仅在请求参数 extra_body.provider.enable_image_base64 设置为 true 时返回此字段。默认值为 false，此时不返回此字段	Base64 编码的字符串
usage	object	是	使用情况统计	对象类型
usage.total_tokens	integer	是	总 token 数	整数，图像生成场景通常为 0
usage.input_tokens	integer	是	输入 token 数	整数，图像生成场景通常为 0
usage.output_tokens	integer	是	输出 token 数	整数，图像生成场景通常为 0
usage.input_tokens_details	object	是	输入 token 详情	对象类型
usage.input_tokens_details.text_tokens	integer	是	文本 token 数	整数，图像生成场景通常为 0
usage.input_tokens_details.image_tokens	integer	是	图像 token 数	整数，图像生成场景通常为 0
usage.image_count	integer	是	生成的图像数量	整数，大于等于 1
provider	string	是	供应商名称	字符串，如"讯飞星辰"
model	string	是	模型名称	字符串，如"xunfei"
origin_data	object	否	供应商的原始响应数据。控制参数：仅在请求参数 extra_body.provider.enable_image_origin_data 设置为 true 时返回此字段。默认值为 false，此时不返回此字段	对象类型，包含供应商 API 的完整原始响应

错误响应

当 API 调用失败时，会返回供应商的原始错误信息。

错误响应格式:

• 如果响应是 JSON 格式，返回完整的错误 JSON 对象
• 如果响应是文本格式，返回错误文本
• 如果无法解析，返回 HTTP {status_code}

错误响应示例:

{
  "error": {
    "message": "Invalid parameter",
    "code": "invalid_param"
  }
}

注意事项

1. 模型参数限制: 不同模型支持的参数不同。对于不在白名单中的参数，系统会记录警告日志，但不会过滤，仍会传递给供应商 API 进行最终判断

2. 参数透传: 所有参数（包括 width、height、guidance_scale 等）都会透传给供应商 API，由供应商进行校验和判断

3. 内容审核:

   • 输入的提示词会经过审核，包含敏感信息会返回错误码 10021
   • 生成的图片也会经过审核，包含敏感信息会返回错误码 10022

4. 未知参数处理: 未知参数会被记录警告日志，但仍会传递给供应商 API，由供应商判断是否返回错误

5. 错误码说明:

   • 0: 成功
   • 10003: 用户的消息格式有错误
   • 10004: 用户数据的 schema 错误
   • 10005: 用户参数值有错误
   • 10008: 服务容量不足
   • 10021: 输入审核不通过
   • 10022: 模型生产的图片涉及敏感信息，审核不通过

6. 供应商调度参数：关于 extra_body.provider 参数的完整说明和使用示例，请参考供应商调度参数说明