交易平台

black-forest-labs/flux-kontext-max/text-to-image ​

Images generations ​

请求说明 ​

  • 基本信息

请求地址：https://api-ml.tiangangaitp.com/v1/images/generations

请求方式：POST

  • Header参数
名称类型必填描述
Content-TypeString是固定值application/json
AuthorizationString是"Bearer" + Apikey
  • Body参数
字段名类型是否必须默认值描述
promptstring必须-提示词
modelstring必须-本次请求使用的模型名称，此处为 black-forest-labs/flux-kontext-max/text-to-image
。
nint可选1生成图片数量，取值范围 1~4
aspect_ratiostring可选"1:1"图像的宽高比，格式为 "宽度:高度"，例如 "16:9" 或 "1:1"。 支持尺寸："21:9", "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16", "9:21"
seedint可选-1随机数种子，用于控制模型生成内容的随机性。如果希望生成内容保持一致，可以使用相同的 seed 参数值。
stepsint可选20推理次数, 取值范围 1~50
guidance_scalefloat可选2.5模型输出结果与 prompt 的一致程度，即生成图像的自由度；值越大，模型自由度越小，与用户输入的提示词相关性越强。 取值[1, 10]。
negative_promptstring可选-负面提示词，用于指定不希望在生成图像中出现的内容
response_formatstring可选"url"指定返回生成图像的格式，默认为 url，可选 b64_json

响应说明 ​

字段名类型描述
createdinteger本次请求创建时间的 Unix 时间戳（秒）。
dataarray输出图像的信息，包括图像下载的 URL 或 Base64。 • 当指定返回生成图像的格式为 url 时，则相应参数的子字段为 url； • 当指定返回生成图像的格式为 b64_json 时，则相应参数的子字段为 b64_json。 注意：链接将在生成后 7 天内失效，请务必及时保存图像。
errorObject错误信息对象
error.codestring错误码
error.messagestring错误提示信息
error.paramstring请求 id

请求示例 ​

示例如下，请将参数示例值替换为实际值。

  • 纯文本请求示例
powershell
curl --request POST \
  --url https://api-ml.tiangangaitp.com/v1/images/generations \
  --header 'Authorization: Bearer $API_KEY' \
  --data '{
  "model": "black-forest-labs/flux-kontext-max/text-to-image",
  "prompt": "Generate a running kitten with a snow capped mountain background",
  "negative_prompt": "",
  "n": 1,
  "size": "1024x1024",
  "strength": 0.8,
  "seed": -1,
  "steps": 20,
  "guidance_scale": 2.5,
  "response_format": "b64_json"
}'
curl --request POST \
  --url https://api-ml.tiangangaitp.com/v1/images/generations \
  --header 'Authorization: Bearer $API_KEY' \
  --data '{
  "model": "black-forest-labs/flux-kontext-max/text-to-image",
  "prompt": "Generate a running kitten with a snow capped mountain background",
  "negative_prompt": "",
  "n": 1,
  "size": "1024x1024",
  "strength": 0.8,
  "seed": -1,
  "steps": 20,
  "guidance_scale": 2.5,
  "response_format": "b64_json"
}'
  • 响应结果
powershell
{
	"code": 100000,
	"msg": "SUCCESS",
	"data": {
		"urls": [
			"https://publicread.tiangangaitp.com/ai-model/image/1n3puzz6pg_1770110903354.png"
		]
	}
}
{
	"code": 100000,
	"msg": "SUCCESS",
	"data": {
		"urls": [
			"https://publicread.tiangangaitp.com/ai-model/image/1n3puzz6pg_1770110903354.png"
		]
	}
}

Apikey 获取方式 ​

通过创建推理接入点，购买调用次数包，获取您的APP key。

接入点->创建推理接入点->查看 API->基本信息->APP key。