图像生成

POST

https://api.tokencube.net/v2/llm/images/generations

图像生成API，接收用户的文本描述（Prompt），返回AI生成的全新图像，适用于创意设计、内容创作等场景。

当前展示通用接口文档，各模型支持的参数存在差异。请在顶部切换模型，或直接点击下方模型标签，查看专属文档。

支持模型:

请求参数

请求头

参数名称	描述
Authorizationstring	鉴权令牌，格式为 Bearer ${AIGATEWAY_TOKEN}
Content-Typestring	可选值：application/json application/json

Body参数

参数名称	描述
modelstring	默认值：Per AI gateway configuration 模型 ID，固定值
promptstring	生成图像的核心提示词，描述图像内容与风格
ninteger	默认值：1 可选值：>0 生成图像的数量（部分模型可能限制为1）
response_formatstring	默认值：url 可选值：urlb64_json 图像返回格式（部分模型可能限制格式）
sizestring	默认值：1024x1024 可选值：Varies by model 图像宽高像素（部分模型可能限制分辨率）
stylestring	图像风格（仅OpenAI系支持）
qualitystring	默认值：auto 图像质量（可能影响生成时间和输出效果，仅OpenAI系支持）
userstring	用户标识，用于指定生成请求用户（仅OpenAI系支持）

请求示例

curl -v 'https://${base_url}/v2/llm/images/generations' \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Sunset by the sea",
    "size": "1440x900"
  }'

响应参数

Body参数

参数名称	描述
createdinteger	图像创建的时间戳（Unix时间格式）
dataarray	生成的图像数组，数组长度与请求参数n一致（部分模型固定为1）
urlstring	图像的URL地址，仅当response_format=url时返回（必填）
b64_jsonstring	图像内容的Base64编码，仅当response_format=b64_json时返回（必填）

响应示例

{
  "created": 1754372091,
  "data": [
    {
      "url": "https://wcs-upload.edgecloudapp.com/0217543720879312b09856"
    }
  ]
}

状态码

描述（message）	HTTP状态码
请求成功，返回生成的图像数据	200
访问被拒绝，拒绝原因见响应主体。可能原因：缺少Authorization请求头、token无效或过期等	401
访问被拒绝，拒绝原因见响应主体。可能原因：请求主体JSON格式错误、缺少必填参数（如prompt）等	403
服务器内部错误，错误原因见响应主体	500

请求参数

请求示例

响应参数

响应示例

状态码

目录