接口信息

API Path 

/aipaas/lm/v1/text/picture

请求协议

HTTP

请求方法

POST

请求头部：

请求参数 Json Object

响应内容：

返回结果

成功 (200) Json Object

成功示例[Mock API]：

{
    "code": "10000",
    "msg": "调用成功",
    "requestId": "test001"
}

失败示例[Mock API]：

{
    "code": "10903",
    "msg": "服务执行失败",
    "requestId": "test001"
}

功能简介

该算法提供根据输入文字和风格制作并生成结果图片的能力。

服务鉴权

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

状态码说明

通用状态码请参见【状态码】中的【网关认证】，其余状态码如下：

请求参数示例

{
    "seq_id": "test001",
    "task_id": 10001,
    "prompt": "丁香一样结着愁怨的姑娘",
    "resolution_ratio": [1, 1],
    "style": 2,
    "batch_size": 1,
        "callback_url": "http://your-callback-address"
}

请求示例

Java版本

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONObject;
import cn.hutool.json.JSONUtil;

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

public class ImageGenerateText2Image {

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

    /**
     * 方法中使用到的 JSONObject、HttpRequest、HttpResponse均来自Hutool工具类。
     * 具体maven依赖为：
     *         <dependency>
     *             <groupId>cn.hutool</groupId>
     *             <artifactId>hutool-all</artifactId>
     *             <version>5.8.29</version>
     *         </dependency>
     */
    public static void text2ImageRequest() {
        String url = "服务调用地址";
        // 设置请求头
        Map<String, String> headers = new HashMap<>();
        //公网调用鉴权
        headers.put("X-APP-ID", "yourAppId");
        headers.put("Authorization", "yourAuthorization");
        headers.put("Content-Type", "application/json");
        // 创建请求对象
        Map<String, Object> request = new HashMap<>();
        request.put("seq_id", "test001");
        request.put("task_id", 10001);
        request.put("prompt", "丁香一样结着愁怨的姑娘");
        request.put("resolution_ratio", Arrays.asList(1, 1));
        request.put("style", 2);
        request.put("batch_size", 1);
        request.put("return_mode", 1);
        // 将请求对象转换为
        String requestString = JSONUtil.toJsonStr(request);
        // 发起HTTP请求
        HttpResponse response =
                HttpRequest.post(url)
                        .headerMap(headers, false)
                        .body(requestString)
                        .execute();
        // 打印返回结果
        System.out.println(response.body());
    }
}

Python示例

import requests
import json
import logging

# 配置日志
logging.basicConfig(level=logging.INFO, format=\'%(asctime)s - %(levelname)s - %(message)s\')
logger = logging.getLogger(__name__)

def text_to_image_request_enhanced():
    """
    增强版的文本转图像请求函数
    包含更详细的日志记录和错误处理
    """
    try:
        url = "服务调用地址"
        headers = {
            "X-APP-ID": "yourAppId",
            "Authorization": "yourAuthorization",
            "Content-Type": "application/json"
        }

        # 构建请求体
        request_body = {
            "seq_id": "test001",
            "task_id": 10001,
            "prompt": "丁香一样结着愁怨的姑娘",
            "resolution_ratio": [1, 1],
            "style": 2,
            "batch_size": 1,
            "return_mode": 1
        }

        logger.info(f"准备发送文本生成图像请求到: {url}")
        logger.debug(f"请求头: {headers}")
        logger.debug(f"请求体: {json.dumps(request_body, indent=2, ensure_ascii=False)}")

        # 发送POST请求
        response = requests.post(
            url=url,
            headers=headers,
            json=request_body,
            timeout=30
        )

        logger.info(f"响应状态码: {response.status_code}")

        # 处理响应
        if response.status_code == 200:
            try:
                response_data = response.json()
                logger.info("文本生成图像请求成功完成")
                logger.debug(f"完整响应: {json.dumps(response_data, indent=2, ensure_ascii=False)}")

                # 通常响应中会包含生成的图像数据或图像URL
                if "image_url" in response_data:
                    logger.info(f"生成图像URL: {response_data[\'image_url\']}")
                elif "image_data" in response_data:
                    logger.info("收到图像数据（Base64编码）")

                return response_data

            except json.JSONDecodeError:
                logger.error("响应不是有效的JSON格式")
                logger.error(f"原始响应: {response.text}")
                return None

        else:
            logger.error(f"文本生成图像请求失败，状态码: {response.status_code}")
            logger.error(f"错误响应: {response.text}")
            return None

    except requests.exceptions.Timeout:
        logger.error("请求超时，请检查网络连接或稍后重试")
    except requests.exceptions.ConnectionError:
        logger.error("连接错误，请检查URL是否正确或服务是否可用")
    except requests.exceptions.HTTPError as e:
        logger.error(f"HTTP错误: {e}")
    except Exception as e:
        logger.error(f"未预期的错误: {e}")

# 图像处理工具函数
def save_image_from_response(response_data, output_path):
    """
    从响应中提取图像并保存到文件
    """
    try:
        if "image_data" in response_data:
            # 假设图像数据是Base64编码的
            import base64
            image_data = response_data["image_data"]
            if image_data.startswith("data:image"):
                # 处理data URL格式
                image_data = image_data.split(",")[1]

            with open(output_path, "wb") as f:
                f.write(base64.b64decode(image_data))
            logger.info(f"图像已保存到: {output_path}")

        elif "image_url" in response_data:
            # 下载远程图像
            image_url = response_data["image_url"]
            image_response = requests.get(image_url, timeout=30)
            with open(output_path, "wb") as f:
                f.write(image_response.content)
            logger.info(f"图像已从URL下载并保存到: {output_path}")

        else:
            logger.warning("响应中未找到图像数据或图像URL")

    except Exception as e:
        logger.error(f"保存图像时出错: {e}")

# 主程序
if __name__ == "__main__":
    result = text_to_image_request_enhanced()
    if result:
        # 保存生成的图像（假设响应中包含图像数据）
        save_image_from_response(result, "generated_image.jpg")
        print("文本生成图像任务完成")