活动

天翼云最新优惠活动,涵盖免费试用,产品折扣等,助您降本增效!
热门活动
  • 安全隔离版OpenClaw NEW OpenClaw云服务器专属“龙虾“套餐低至1.5折起
  • 聚力AI赋能 天翼云大模型专项 大模型特惠专区·Token Plan 轻享包低至9.9元起
  • 青云志云端助力计划 NEW 一站式科研助手,海外资源安全访问平台,助力青年翼展宏图,平步青云
  • 企业出海解决方案 NEW 助力您的业务扬帆出海,通达全球!
  • 天翼云信创专区 NEW “一云多芯、一云多态”,国产化软件全面适配,国产操作系统及硬件芯片支持丰富
  • 中小企业服务商合作专区 国家云助力中小企业腾飞,高额上云补贴重磅上线
  • 云上钜惠 爆款云主机全场特惠,2核4G只要1.8折起!
  • 天翼云奖励推广计划 加入成为云推官,推荐新用户注册下单得现金奖励
免费活动
  • 免费试用中心 HOT 多款云产品免费试用,快来开启云上之旅
  • 天翼云用户体验官 NEW 您的洞察,重塑科技边界

息壤智算

领先开放的智算服务平台,提供算力、平台、数据、模型、应用“五位一体”智算服务体系,构建全流程的AI基础设施能力
AI Store
  • 算力市场
  • 模型市场
  • 应用市场
公共算力服务
  • 裸金属
  • 定制裸金属
训推服务
  • 模型开发
  • 训练任务
  • 服务部署
星辰TokenHub
  • 模型广场
  • 体验中心
  • 服务接入
应用托管
  • 应用实例
科研助手
  • 科研智能体
  • 科研服务
  • 开发机
  • 并行计算
大模型
  • DeepSeek-V4-Flash
  • GLM-5.1
  • Qwen3.5-122B-A10B
  • DeepSeek-V3.2(旗舰版)
  • GLM-5(正式版)
智算一体机
  • 智算一体机
智能体引擎
  • 智能体引擎
可信数据空间
  • 可信数据空间
模型适配专家服务
  • 模型适配专家服务
算力服务商
  • 入驻算力服务商

应用商城

天翼云精选行业优秀合作伙伴及千余款商品,提供一站式云上应用服务
进入甄选商城进入云市场进入AI Store创新解决方案公有云生态专区智云上海应用生态专区
建站工具
  • 新域名服务
  • SSL证书
  • 翼建站
企业办公
  • 安全邮箱
  • WPS 365 天翼云版
  • 天翼企业云盘(标准服务版)
灾备迁移
  • 云管家2.0
  • 翼备份(SaaS版)

定价

协助您快速了解云产品计费模式、价格详情,轻松预估上云成本
价格计算器
  • 动态测算产品价格
定价策略
  • 快速了解计费模式

合作伙伴

天翼云携手合作伙伴,共创云上生态,合作共赢
天翼云生态合作中心
  • 天翼云生态合作中心
天翼云渠道合作伙伴
  • 天翼云代理渠道合作伙伴
天翼云服务合作伙伴
  • 天翼云集成商交付能力认证
天翼云应用合作伙伴
  • 天翼云云市场合作伙伴
  • 天翼云甄选商城合作伙伴
天翼云技术合作伙伴
  • 天翼云OpenAPI中心
天翼云培训认证
  • 天翼云学堂
  • 天翼云市场商学院
天翼云合作计划
  • 云汇计划
天翼信创云专区
  • 信创云专区
  • 适配互认证

开发者

开发者相关功能入口汇聚
技术社区
  • 专栏文章
  • 互动问答
  • 技术视频
资源与工具
  • OpenAPI中心
培训与认证
  • 天翼云学堂
  • 天翼云认证
开源社区
  • 魔乐社区
  • OpenTeleDB

支持与服务

为您提供全方位支持与服务,全流程技术保障,助您轻松上云,安全无忧
文档与工具
  • 文档中心
  • 新手上云
  • 自助服务
  • OpenAPI中心
定价
  • 价格计算器
  • 定价策略
基础服务
  • 售前咨询
  • 在线支持
  • 在线支持
  • 工单服务
  • 服务保障
  • 会员中心
增值服务
  • 红心服务
  • 首保服务
  • 客户支持计划
  • 专家技术服务
  • 备案管家
我要反馈
  • 建议与反馈
  • 用户体验官
信息公告
  • 客户公告

了解天翼云

天翼云秉承央企使命,致力于成为数字经济主力军,投身科技强国伟大事业,为用户提供安全、普惠云服务
品牌介绍
  • 关于天翼云
  • 智算云
  • 天翼云4.0
  • 新闻资讯
  • 天翼云APP
基础设施
  • 全球基础设施
  • 信任中心
最佳实践
  • 精选案例
  • 超级探访
  • 云杂志
  • 分析师和白皮书
  • 天翼云·创新直播间
市场活动
  • 2026智能云生态大会
  • 2025智能云生态大会
  • 2024智算云生态大会
  • 2023云生态大会
  • 2022云生态大会
  • 天翼云中国行
天翼云
  • 活动
  • 息壤智算
  • 产品
  • 解决方案
  • 应用商城
  • 定价
  • 合作伙伴
  • 开发者
  • 支持与服务
  • 了解天翼云
      • 文档
      • 控制中心
      • 备案
      • 管理中心
      文档中心

      星辰MaaS模型服务平台

      星辰MaaS模型服务平台

      • 星辰MaaS模型服务平台

      无数据

        • 产品介绍
        • 产品定义
        • 产品优势
        • 术语解释
        • 模型使用限制
        • 计费说明
        • 模型推理计费规则
        • 模型训推计费规则
        • 欠费说明
        • 账单和发票
        • 快速入门
        • 准备工作
        • 快速入门
        • 用户指南
        • 模型广场
        • 体验中心
        • 数据管理
        • 公共数据集
        • 我的数据集
        • 模型推理
        • 模型训练
        • 模型调优
        • 我的模型
        • 模型部署
        • 服务部署
        • 模型量化
        • 系统管理
        • API Key
        • 操作日志
        • 常见问题
        • 常见问题
        • 最佳实践
        • 零门槛CV大模型训推
        • API参考
        • 开发指南
        • 开发指南
        • 异步调用结果获取
        • 大模型异步调用结果回查
        • 状态码说明
        • 实时超自然语音合成-普通话版
        • 能力介绍
        • 接口文档
        • 超多方言实时语音识别
        • 能力介绍
        • 接口文档
        • 通用问答版大模型-36B
        • 能力介绍
        • 接口文档
        • 对话大模型
        • 能力介绍
        • 接口文档
        • 文生图大模型
        • 能力介绍
        • 接口文档
        • 图生图大模型
        • 能力介绍
        • 接口文档
        • 文档下载
        • 相关协议
        • 星辰MaaS模型推理服务协议
        • 星辰MaaS模型推理服务用户信息处理规则
        • 生成式人工智能服务备案信息参考
        • 星辰MaaS模型定制开发服务协议
          无相关产品

          本页目录

          帮助中心 星辰MaaS模型服务平台 API参考 图生图大模型 接口文档
          接口文档
          更新时间 2026-06-05 17:10:08
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          最近更新时间: 2026-06-05 17:10:08
          分享文章
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接

          接口信息

          API Path /aipaas/lm/v1/picture/picture

          请求协议 HTTP

          请求方法 POST

          请求头部:

          头部标签必填说明类型数据字典限制头部内容示例
          Content-Type是application/json[string]--application/jsonapplication/json
          X-APP-ID是系统管理--API Key,创建应用获取AppID 和AppKey,公网鉴权,公网调用时必传[string]----
          Authorization是公网鉴权,公网调用时必传[string]----
          Device-Uuid否设备管理-设备uuid[string]----

          请求参数 Json Object

          参数名说明必填类型数据字典限制示例
          seq_id请求序列号,请求的唯一标识是[string]---
          task_id能力编号,当前能力编号为20001是[int]---
          image输入图片url是[array]---
          style生成风格是[int]0:冬日暖阳,1:薰衣草,2:宇航员,3:梅花汉服,4:圣诞(室外),5:圣诞(室内),6:烟花盛典,7:街景机甲,8:喜迎新春,9:龙年大吉,10:新春闪耀,11:东北往事,12:时代风华--
          batch_size生成图片数量,目前只支持传1否[int]---
          callback_url接收回调结果的url地址,return_mode为0是必传否[string]---
          return_mode结果返回模式,0:push,1:pull,默认为0。push模式即提供callback_url接收最终结果回调;pull模型即通过大模型异步调用结果回查接口查询最终调用结果,接口文档详见开发指南下的大模型异步调用结果回查。否[int]---

          响应内容:

          返回结果

          成功 (200) Json Object

          参数名说明必填类型数据字典限制示例
          code状态响应码。参考错误编码规范是[string]---
          msg调用结果描述。参考错误编码规范是[string]---
          requestId请求ID,用于调用查询大模型生成结果信息接口是[string]---

          成功示例[Mock API]:

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

          失败示例[Mock API]:

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

          功能简介

          该功能提供根据指定风格对输入图片进行加工,并生成加工后图片的能力。

          服务鉴权

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

          状态码说明

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

          返回编码返回信息说明
          10000服务执行成功服务执行成功
          10100算法模型异常算法模型调用失败(超时)
          10101结果图片不合规算法生成图片存在不合规元素,不进行输出
          10200图片下载异常图片 url 访问失败,下载异常
          10201图片格式错误下载后的图片格式不对,非图片(除 jpeg, png, jpg)
          10202算法推理异常算法推理失败,生成图片失败
          10203图片上传异常结果图片上传 ceph/minIO 失败
          10204图片分辨率过小图片分辨率过小,无法正常生成结果
          10205图片检测到多个人脸图片检测到多个人脸
          10206图片面部较小图片检测到脸部过小
          10207人脸仅检测到侧脸人脸只检测到侧脸
          10208图片不存在人脸图片不存在人脸
          10209图片姿态不符合要求人脸朝向不符合要求
          10210图片面部存在遮挡人脸存在遮挡情况
          10211图片面部模糊图片人脸过于模糊
          10212图片非全身照图片中的人物非全身照,可能存在人体部分被遮挡情况
          10213图片脸部不完整图片脸部不完整
          10301服务必填参数缺失服务必填参数缺失或未填写
          10304服务入参错误部分参数存在限制说明,会针对入参做校验返回;例如传入的 style 风格不在范围内,prompt 入参不合规等情况
          10903服务执行失败服务执行失败(可能存在组件连接异常、算法模型程序运行异常等情况,导致服务无法正常运行)

          请求参数示例

          {
              "seq_id": "a504324c-6e10-11e8-adf0-58fb8443ee27",
              "task_id": 20001,
              "image": ["http://xxx"],
              "style": 0,
              "batch_size": 1,
              "callback_url": "http://callbackUrl"
          }

          回告结果

          接口回告结果信息详见同级目录下的【回告数据结构】。

          调用示例

          Java版本

          import cn.hutool.http.HttpRequest;
          import cn.hutool.http.HttpResponse;
          import cn.hutool.json.JSONUtil;
          
          import java.util.Arrays;
          import java.util.HashMap;
          import java.util.Map;
          
          /** 主类,用于发起HTTP请求并处理响应 */
          public class Example {
          
              public static void main(String[] args) {
                  example();
              }
          
                  /**
                   * 方法中使用到的 JSONUtil、HttpRequest、HttpResponse均来自Hutool工具类。
                   * 具体maven依赖为:
                   *         <dependency>
                   *             <groupId>cn.hutool</groupId>
                   *             <artifactId>hutool-all</artifactId>
                   *             <version>5.8.29</version>
                   *         </dependency>
                   */
          
              public static void example() {
                  try {
                      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", "20001");
                      request.put("image", Arrays.asList("yourImageUrl"));
                      request.put("batch_size", 1);
                      request.put("style", 0);
                      request.put("callback_url", "yourCallbackUrl");
                      // 将请求对象转换为JsonNode
                      String requestString = JSONUtil.toJsonStr(request);
          
                      // 发起HTTP请求
                      HttpResponse response =
                              HttpRequest.post(url)
                                      .headerMap(headers, true)
                                      .body(requestString)
                                      .execute();
                      // 输出响应结果
                      System.out.println(response.body());
                  } catch (Exception e) {
                      e.printStackTrace();
                  }
              }
          
          }

          Python示例

          import requests
          import json
          import logging
          
          # 配置日志
          logging.basicConfig(level=logging.INFO, format=\'%(asctime)s - %(levelname)s - %(message)s\')
          logger = logging.getLogger(__name__)
          
          def send_post_request_enhanced():
          
              try:
                  url = "算法调用地址"
          
                  headers = {
                      "Content-Type": "application/json",
                      "X-APP-ID": "xxxxx",
                      "Authorization": "xxxx",
                      # "Device-Uuid": "yourDeviceUuid"  # 可选
                  }
          
                  # 构建请求体
                  request_body = {
                      "seq_id": "test001",
                      "task_id": "20001",
                      "image": ["http://yourImageUrl"],
                      "batch_size": 1,
                      "style": 0,
                      "callback_url": "yourCallbackUrl"
                  }
          
                  logger.info(f"准备发送POST请求到: {url}")
                  logger.info(f"请求头: {headers}")
                  logger.info(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("POST请求成功")
          
                          # 检查响应中的code字段
                          code = response_data.get("code")
                          message = response_data.get("message")
                          logger.info(f"code: {code}")
                          logger.info(f"message: {message}")
          
                      except json.JSONDecodeError:
                          logger.error("响应不是有效的JSON格式")
                          logger.error(f"原始响应: {response.text}")
                          return response.text
                  else:
                      logger.error(f"POST请求失败,状态码: {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}")
          
          # 调用增强版函数
          if __name__ == "__main__":
              result = send_post_request_enhanced()
              if result:
                  print("请求处理完成")
          文档反馈

          建议您登录后反馈,可在建议与反馈里查看问题处理进度

          鼠标选中文档,精准反馈问题

          选中存在疑惑的内容,即可快速反馈问题,我们会跟进处理

          知道了

          上一篇 :  能力介绍
          下一篇 :  文档下载
          搜索 关闭
          ©2026 天翼云科技有限公司版权所有 增值电信业务经营许可证A2.B1.B2-20090001
          公司地址:北京市东城区青龙胡同甲1号、3号2幢2层205-32室
          备案 京公网安备11010802043424号 京ICP备 2021034386号
          ©2026天翼云科技有限公司版权所有
          京ICP备 2021034386号
          备案 京公网安备11010802043424号
          增值电信业务经营许可证A2.B1.B2-20090001
          用户协议 隐私政策 法律声明