创建图片生成请求

请求方法

POST： <ai-api-base-url>/llm/v1/images/generations

其中，<ai-api-base-url> 为您的 API Key 所属数据中心的域名。目前仅支持北京数据中心的域名：https://ai.rong-api.com。

请求头参数

参数名	类型	是否必填	默认值	说明
Authorization	string	是	-	身份认证信息，格式为 Bearer <your API key>，用于验证用户权限。

正文参数

参数名	类型	是否必填	默认值	说明
model	enum	是	-	暂无公开发布的图片生成模型。若需使用图片生成模型，请联系商务经理。
prompt	string	是	-	正向提示词，描述希望生成的图像内容（如场景、元素、风格等）。
image_size	enum	是	1024×1024	生成图片的尺寸，可选值包括 960x1280、768x1024 等， others 表示自定义尺寸（需按模型支持格式传入）。
batch_size	integer	是	1	一次性生成的图片数量，范围为 1 ≤ x ≤ 4。
num_inference_steps	integer	是	20	推理步数，控制生成图片的计算次数。步数越多，细节越精细，耗时越长（范围 1 ≤ x ≤ 100）。
guidance_scale	number	是	7.5	引导尺度，控制生成图片与提示词的匹配程度： 高值（如 20）：严格匹配提示词，创意性较低； 低值（如 0）：更具创造性，可能包含意外元素（范围 0 <= x <= 20）。
negative_prompt	string	否	-	负向提示词，用于排除不希望出现的元素或风格（如“模糊”“低分辨率”）。
seed	integer	否	-	随机种子，用于控制生成结果的可复现性。相同种子+相同参数可生成相同图片（范围 0 ≤ x ≤ 99999999999）。
image	string(base64)	否	-	可选输入图像（用于图生图或编辑场景），需转换为 Base64 格式（如 data:image/png;base64,XXX）。

请求示例

cURL

bash

 curl --location '<ai-api-base-url>/llm/v1/images/generations' \
 --header 'Authorization: Bearer <token>' \
 --header 'Content-Type: application/json' \
 --data '{
   "model": "Kwai-Kolors/Kolors",
   "prompt": "人生是无边无际的旷野",
   "image_size": "1024x1024",
   "prompt_enhancement": false
 }'

Python

python

 import requests

 url = "<ai-api-base-url>/llm/v1/images/generations"

 payload = {
     "model": "Kwai-Kolors/Kolors",
     "prompt": "人生是无边无际的旷野",
     "image_size": "1024x1024",
     "prompt_enhancement": false

 }
 headers = {
     "Authorization": "Bearer <token>",
     "Content-Type": "application/json"
 }

 response = requests.request("POST", url, json=payload, headers=headers)

 print(response.text)

JavaScript

JavaScript

 const options = {
   method: 'POST',
   headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
   body: '{"model":"Kwai-Kolors/Kolors","prompt":"人生是无边无际的旷野","image_size":"1024x1024","prompt_enhancement":false}'
 };

 fetch('<ai-api-base-url>/llm/v1/images/generations', options)
   .then(response => response.json())
   .then(response => console.log(response))
   .catch(err => console.error(err));

响应参数

参数名	类型	是否必返	说明
images	object[]	是	生成的图片信息列表，每个元素包含： url：图片下载地址（有效期 1 小时，需及时保存）； width：图片宽度； height：图片高度。
timings	object	是	生成图片的时间统计信息，包含： total_time：总耗时（单位：秒）； 其他细分阶段耗时（如模型推理时间）。
seed	integer	是	本次生成使用的随机种子（若未指定则为自动生成），用于复现结果。

返回结果示例

JSON

  {
    "images": [
      {
        "url": "<string>"
      }
    ],
    "timings": {
      "inference": 123
    },
    "seed": 123
  }