PersonalizedTextToImageAddInferenceJob - 添加预置模型推理任务-智能科教内容生成平台(SSECP)-阿里云帮助中心

个性化文生图/基于一个预训练模型创建图片推理任务。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aicontent:PersonalizedTextToImageAddPreModelInferenceJob

create

*全部资源

*

无

请求语法

POST /api/v1/personalizedtxt2img/addPreModelInferenceJob HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体对象。
imageUrl	array	是	包含图片链接的列表, 可包含单张或多张图片的链接, 如["url_1", "url_2", ...]
	string	否	图片地址，须确保能够有效访问，否则页面无法展示	https://img.alicdn.com/imgextra/i2/O1CN011Ps6OK1LdWZQSUZD1_!!6000000001322-0-tps-572-1096.jpg
trainSteps	integer	否	模型训练任务训练步骤	800
prompt	string	是	英文 prompt 描述生成的图像, 要生成的角色用替代, 如“a man in the snow”要改为"a in the snow", "a photo of a girl"改为"a photo of a "	a in the snow
imageNumber	integer	否	要生成图片的数量。注意: 由于测试环境资源限制，一次最多生成 10 张图片, 该值大于 10 按 10 处理	1
seed	integer	否	随机数种子，该种子固定时可以得到相同的生成图像，确保结果的可复现性，注意: 输入值需处于[-1, 2147483647]，输入值在该区间外或者不输入时将自动生成一个合适的种子。	1
strength	number	否	表示输入的参考图像对生成过程的影响强度，取值范围是 [0.3, 0.4, 0.5, 0.6, 0.7, 0.8]，值越小，表示参考图像对生成的影响强度越低，相应的，文本对生成过程的影响强度越高。默认是 0.5，一般情况不需要设置，保持默认。	1

返回参数

名称	类型	描述	示例值
	object	OpenApiSingleResponse	{"success":true,"errCode":null,"errMessage":null,"requestId":"abec5678-3536-4808-ab5a-eb165cd9109f","data":{"id":"1","promptId":"prompt_id-xxxx-xxxx-xxxx-xxxx","modelId":"model_id-xxxx-xxxx-xxxx-xxxx","jobStatus":"WAIT_SCHEDULE","resultImageUrl":null,"createUserId":"109988888888","createTime":"2024-06-28T11:02:32.441184"}}
requestId	string	请求编号	xxxx-xxxx-xxxx-xxxxxxxx
success	boolean	是否成功	true
errCode	string	错误信息编码	UNKNOWN_ERROR
errMessage	string	错误信息	未知错误
httpStatusCode	integer	http 状态码	200
data	object	数据对象	[]
id	string	模型推理任务 id	3220
promptId	string	promptId	promptId-xxxx-xxxx-xxxx
modelId	string	模型 Id	modelId-xxxx-xxxx-xxxx
jobStatus	string	模型推理任务状态	FINISHED
jobTrainProgress	number	模型推理任务进度	0.5
resultImageUrl	array	模型推理任务结果列表	0000.png
	string	模型推理任务结果列表	0000.png
createTime	string	模型推理任务创建时间	2023-12-25T12:00:00

示例

正常返回示例

JSON格式

{
  "requestId": "xxxx-xxxx-xxxx-xxxxxxxx",
  "success": true,
  "errCode": "UNKNOWN_ERROR",
  "errMessage": "未知错误",
  "httpStatusCode": 200,
  "data": {
    "id": "3220",
    "promptId": "promptId-xxxx-xxxx-xxxx",
    "modelId": "modelId-xxxx-xxxx-xxxx",
    "jobStatus": "FINISHED",
    "jobTrainProgress": 0.5,
    "resultImageUrl": [
      "0000.png"
    ],
    "createTime": "2023-12-25T12:00:00"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。