收起侧栏

主体注入-接口文档

最近更新时间: 2026-05-18 08:39:53

8000500011(推理服务-V3.3.0)

接口信息

API Path
/aipaas/mllm/v1/subjectInjection/multimodal

请求协议
HTTPS

请求方法
POST

请求头部：

头部标签	必填	说明	头部内容	示例
Content-Type	是	内容类型	application/json	application/json
X-APP-ID	是	控制台--应用管理--AppID
Device-Uuid	是	设备管理-设备uuid
Authorization	是	鉴权信息

请求参数 Json
Object

参数名	说明	必填	类型	限制	示例
seq_id	请求序列号，请求的唯一标识	是	[string]	0	5183b530-4c0c-11f0-b384-61e09dc788ee
task_id	算法能力编号【各算法自定义并在接口文档中体现】	是	[int]	0	10001
prompt	文本内容	是	[string]	0	蓝天草地马儿跑
image	输入图片，url或base64，必须传入，最多支持三张图片，图片最小长/宽>350，图片不宜过大	是	[array]	0	["http://xxxx.jpg"]
image_type	输入图片类型，默认0，0表示输入图片URL，1表示输入图片BASE64	否	[int]	0	0
resolution_ratio	输出结果分辨率比例，默认[16,9],可选[1,1]、[9,16]、[16,9]、[4,3]、[3, 4]、[2,3]、[3,2]	否	[array]	0	[16,9]
callback_url	回调地址	否	[string]	0	"http://xxxx.jpg"
return_mode	结果返回模式，0:push，1:pull，默认为0。push模式即提供callback_url接收最终结果回调；pull模型即通过大模型异步调用结果回查接口查询最终调用结果，接口文档详见开发指南下的大模型异步调用结果回查。	否	[int]	32
extra_message	扩展参数列表,，填充规则见4.1中请求扩展参数说明	否	[array]	0
extra_message>>key	参数名称，如果填入的名称不是seed或quality不会报错	否	[string]	0	seed
extra_message>>value	参数值，取值范围见上述请求扩展参数说明	否	[object]	0	0

响应内容：

返回结果

成功 (200)
Json
Object

参数名	说明	必填	类型	示例
seq_id	请求序列号，同输入的seq_id	是	[string]	5183b530-4c0c-11f0-b384-61e09dc788ee
send_pts_ms	时间戳	是	[long]	1750239877
code	状态响应码。参考错误编码规范	是	[string]	10000
message	调用结果描述。参考错误编码规范	是	[string]	服务执行成功
task_id	算法能力编号，同输入的task_id	是	[int]	10001
flag	业务上成功或失败：1成功，0失败	是	[int]	1
data	返回结果，code码为10000时有此字段，否则没有此字段	否	[object]
data>>status	状态：0-未开始，1-执行中，2-执行成功，3-执行失败	是	[int]	2
data>>task_result	任务执行结果	是	[object]
data>>task_result>>out_image	输出的图片url、base64或者图片详细信息【各算法自定义并在接口文档中体现】	是	[array]	[ "http://xxx.xxx/xxx.jpg", "/9j*", { "edge_analysis": "/9j", "lighting_analysis": "/9j", "saturation_analysis": "/9j", "noise_analysis": "/9j", "frequency_analysis": "/9j", "compression_alignment_analysis": "/9j", "cfa_analysis": "/9j*" } ]

成功示例

{
    "seq_id": "test_20024-0",
    "task_id": 20024,
    "send_pts_ms": 1765871965726,
    "code": "10000",
    "message": "ok",
    "flag": 1,
    "data": {
        "status": 2,
        "task_result": {
            "out_image": ["wanglaigc/lsstest/test_20019-0_1765871965_0_output.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=admin%2F20251216%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251216T075925Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=0ebe0801fb50f0c09d5c21306ffd5b883b4687b23bb9c1f3dde85af0c4e9eb09"]
        }
    }
}

1、能力简介

本算法根据输入的图片和文本生成图片，并将生成的图片上传S3，返回上传后的url

2、修订历史

修订日期	算法版本号	修订内容
2026-05-11	V3.3.0	工程侧增加人脸质量检测接口开关
2026-04-15	V3.2.0	算法增加图片质量检测
2026-02-11	V3.1.0	算法更新模型权重
2026-02-06	V3.0.1	镜像更新
2026-01-16	V3.0.0	算法更新模型，请求增加quality参数
2025-12-29	V2.0.0	算法更新模型

3、服务鉴权

服务接口调用时需要严格遵循服务鉴权规则，服务调用鉴权规则请参见：开发指南 - 接口签名认证。

4、请求参数说明

4.1、请求扩展参数说明

参数路径：extra_message

参数中文名	参数名称(key)	参数值(value)	必填	内部数据类型	备注
生成图片种子	seed	0-65535整数	否	int	不填默认为0
生成图片质量	quality	支持的质量："highres", "midres", "lowres", "normal"	否	str	不填默认为"normal"
是否经过人脸质量检测	enable_face_quality	支持的参数：true, false,0, 1, "0", "1"	否	bool	不填默认为false

5、响应结果说明

返回的图片的为url链接，使用的话需要做下载，具体下载路径需要在返回的链接前拼接上星河的代理，具体可参考星河接入规范

6、请求示例

{
    "seq_id": "test_20024",
    "task_id": 20024,
    "image": [
        "<http://0.0.0.0:11111/biaoqing_0.jpeg>"
    ],
    "prompt": "纪实摄影，女孩微笑的看向前方，光影感，肌理感，8K分辨率，超高质量。",
    "resolution_ratio": [1,1],
    "callback_url": "<http://localhost:7777/callback>",
    "extra_message": [
        {"key": "seed",
         "value": 100}]
}

7、状态码说明

状态码	状态描述	状态说明
10000	服务执行成功	服务执行成功
10200	图片下载异常	图片url访问失败，下载异常；非图片（只支持 jpeg, png, jpg）
10201	图片质量检测未通过	本服务包括以下情况：分辨率小，短边尺寸小于350；多个人脸，检测到多于1个人脸；检测到侧脸；没有检测到人脸；姿态不符合要求，非正脸；面部存在遮挡，检测到面部遮挡
10202	算法推理异常	算法推理失败
10203	文件上传异常	结果图片上传ceph/minIO失败
10304	服务入参错误	部分参数存在限制说明，会针对入参做校验返回；例如prompt入参不合规等情况
10903	服务执行失败	服务执行失败(可能存在组件连接异常、算法模型程序运行异常等情况，导致服务无法正常运行)

8、调用示例

8.1、java调用示例

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import com.alibaba.fastjson.JSONObject;

import java.util.HashMap;
import java.util.Map;

/**
 * 为保证示例可以正常运行，请确认maven中是否存在以下依赖：
 * <dependency>
 *     <groupId>cn.hutool</groupId>
 *     <artifactId>hutool-all</artifactId>
 *     <version>5.8.29</version>
 * </dependency>
 * <dependency>
 *     <groupId>com.alibaba</groupId>
 *     <artifactId>fastjson</artifactId>
 *     <version>1.2.83</version>
 * </dependency>
 */
public class Example {

    public static void example() {
        try {
            // 算法调用地址，请根据实际情况修改
            String url = "算法调用地址";

            // 设置请求头
            Map<String, String> headers = new HashMap<>();
            headers.put("Content-Type", "application/json");
            headers.put("Device-Uuid", "2018619061498245122");
            headers.put("X-APP-ID", "你实际的AppId");
            headers.put("Authorization", "你实际的Authorization");

            // 设置请求参数，请根据实际情况修改
            String requestString = "{\n" +
"	\"callback_url\":\"\\"<http://xxxx.jpg\\>"\",\n" +
"	\"image\":[],\n" +
"	\"seq_id\":\"5183b530-4c0c-11f0-b384-61e09dc788ee\",\n" +
"	\"task_id\":10001,\n" +
"	\"prompt\":\"蓝天草地马儿跑\",\n" +
"	\"extra_message\":[\n" +
"		{\n" +
"			\"value\":{},\n" +
"			\"key\":\"seed\"\n" +
"		}\n" +
"	],\n" +
"	\"image_type\":0,\n" +
"	\"resolution_ratio\":[]\n" +
"}";

            // 发起HTTP请求
            HttpResponse response = HttpRequest.post(url)
                    .headerMap(headers, true)
                    .body(requestString)
                    .execute();
            // 输出响应结果
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        example();
    }

}

8.2、python调用示例

import json
import hashlib
import hmac
import time
import re
import urllib.parse
import requests
import warnings
from datetime import datetime
import logging

# 配置日志，设置日志级别为INFO，并指定日志格式
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')

# 配置环境变量
X_APP_ID = "yourAppId"
AUTHORIZATION = "yourAuthorization"
# 请求的URL
url = "算法调用地址"
# 请求数据
request_data = {
	"callback_url":"\"<http://xxxx.jpg\>"",
	"image":[],
	"seq_id":"5183b530-4c0c-11f0-b384-61e09dc788ee",
	"task_id":10001,
	"prompt":"蓝天草地马儿跑",
	"extra_message":[
		{
			"value":{},
			"key":"seed"
		}
	],
	"image_type":0,
	"resolution_ratio":[]
}
# 构建请求头
headers = {
    "Content-Type": "application/json",
    "Device-Uuid": "2018619061498245122",
    "X-APP-ID": X_APP_ID,
    "Authorization": AUTHORIZATION
}


def timeSimple(timestamp):
    # 将时间戳转换为HH:MM:SS格式的时间字符串
    dt_object = datetime.fromtimestamp(timestamp)
    formatted_time = dt_object.strftime("%H:%M:%S")
    return formatted_time


def send_request(url):
    try:
        start_time = time.time()
        logging.info(f"请求路径: {url}")
        logging.info(f"开始发送: {timeSimple(start_time)}")

        with requests.post(
            url, json=request_data, headers=headers, stream=True, verify=False
        ) as response:
            first_packet_time = None
            if response.status_code == 200:
                logging.info(f"接受到返回: {timeSimple(time.time())}")

                for chunk in response.iter_content(chunk_size=1024):
                    if chunk:
                        if first_packet_time is None:
                            first_packet_time = time.time()
                        logging.info(
                            f"Received chunk: {timeSimple(time.time())} {chunk.decode('utf-8')}"
                        )

                end_time = time.time()
                logging.info(f"Time to first byte (TTFB): {first_packet_time - start_time:.3f} seconds")
                logging.info(f"Request completed in {end_time - start_time:.3f} seconds")
            else:
                logging.error(f"Request failed with status code {response.status_code}")
    except Exception as e:
        logging.error(f"An error occurred: {e}")


# 发送请求
send_request(url)
logging.info(f"headers = {headers}")

大模型体验中心

开放能力

开发平台

应用产品

解决方案

关于天翼AI

热门搜索