3vjia Technology

3vjia Technology Xuanchi AI API

玄尺AI

GitHub OpenAPI

Operations 48

POST /api/render/aiCreationFeeCalculation 消耗创点数量计算 #
POST /api/render/aiRoomDesign AI空间设计 #
POST /api/render/backgroundPaint 背景图重绘 #
POST /api/render/bricksChange 产品替换-换砖 #
POST /api/render/changeMaterial 产品替换-换材质 #
POST /api/render/checkProductWhiteBg 商品白底图合格检测 #
POST /api/render/comfyCommon 空间填充3.0 #
POST /api/render/comfyTextureChangeV2 产品替换-换墙涂料2.0 #
POST /api/render/comfyTextureChangeV3 换墙涂料3.0 #
POST /api/render/comfyTextureChangeV4 换墙涂料4.0 #
POST /api/render/countertopChange 产品替换-换台面 #
POST /api/render/doorChange 产品替换-换门 #
POST /api/render/entitySegment 物体切割 #
POST /api/render/entitySegmentCoordinate 图像分割(坐标) #
POST /api/render/floorplan3DView 户型3D视角出图 #
POST /api/render/getRenderTaskById AI任务状态查询 #
POST /api/render/imageEdit 图片编辑 #
POST /api/render/imageFragment 图片裂变 #
POST /api/render/imageToVideo 图生视频 #
POST /api/render/imageWhiteBackground 图片白底图 #
POST /api/render/imgExtractObjects 物体识别 #
POST /api/render/imgPromptToImgsV2 电商套图生成 #
POST /api/render/listRenderTemplate 模板配置列表 #
POST /api/render/oldBuildingReconstructionV2 旧房改造2.0 #
POST /api/render/oldBuildingReconstructionV2.1 旧房改造2.1 #
POST /api/render/paintDefectDetection 油漆缺陷检测 #
POST /api/render/picToText 图转文 #
POST /api/render/productAdd 添加产品 #
POST /api/render/productReplaceV1 产品替换1.0 #
POST /api/render/productReplaceV2 产品替换2.0 #
POST /api/render/roughDesignV2 毛坯出图2.0 #
POST /api/render/roughDesignV2.1 毛坯出图2.1 #
POST /api/render/sketchToImage 线稿出图 #
POST /api/render/softDecorationLayoutV2.1 新房软装2.1 #
POST /api/render/textToImage 文生图 #
POST /api/render/textureChange 换墙涂料1.0 #
POST /api/userInfo/roleList 慧引流角色列表 #
POST /api/userInfo/teamCreate 慧引流团队创建 #
POST /api/userInfo/teamGet 慧引流团队获取 #
POST /api/userInfo/teamList 慧引流团队列表 #
POST /api/userInfo/teamRemove 慧引流团队删除 #
POST /api/userInfo/teamUpdate 慧引流团队修改 #
POST /api/userInfo/userCreate 慧引流用户创建 #
POST /api/userInfo/userGet 慧引流用户获取 #
POST /api/userInfo/userPage 慧引流用户分页查询 #
POST /api/userInfo/userRemove 慧引流用户移除 #
POST /api/userInfo/userUpdate 慧引流用户修改 #
POST /api/userLogin/login 慧引流登录 #

Documentation

📖
Documentation
https://dev.3vjia.com/v1/document
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/authentication/3vjia-technology-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/rate-limits/3vjia-technology-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/openapi/3vjia-technology-xuanchi-ai-api-openapi.yml

Other Resources

🔗
DeveloperPortal
https://dev.3vjia.com/
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/asyncapi/3vjia-technology-webhooks.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/errors/3vjia-technology-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/conventions/3vjia-technology-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/data-model/3vjia-technology-data-model.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/mcp/3vjia-technology-tool-crosswalk.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/3vjia-technology-xuanchi-ai-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

3vjia-technology-xuanchi-ai-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: 3vjia Open Platform Xuanchi AI API
  version: '2026-09-05'
  summary: Home-furnishing 3D cloud design, quotation, order, manufacturing (AIMES/MOS/DMS) and AI operations exposed by the 3vjia (三维家) Open Platform.
  description: Machine-readable description of the 3vjia (三维家 / AiHouse) Open Platform, DERIVED — not published by the provider in this form.
  contact:
    name: 3vjia Open Platform
    url: https://dev.3vjia.com/
servers:
- url: https://open-gateway.3vjia.com
  description: 3vjia Open Platform gateway (current)
- url: https://open.3vjia.com
  description: Legacy open gateway — takes ?sysCode=external&access_token=
security:
- oauth2ClientCredentials: []
tags:
- name: Xuanchi AI
  description: 玄尺AI
paths:
  /api/render/aiCreationFeeCalculation:
    post:
      operationId: apiRenderAiCreationFeeCalculation
      summary: 消耗创点数量计算
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=723926385059577893
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                singleCount:
                  type: integer
                  format: int32
                  description: 单次作品数量（如：张、秒、次）, 默认1
                  examples:
                  - '5'
                modelVersion:
                  type: string
                  description: 模型版本
                bizType:
                  type: integer
                  format: int32
                  description: 业务类型：文生图-9；图片裂变-10；图生视频-13；线稿出图-20；毛坯设计2-30；旧房改造2-31；
                  examples:
                  - '13'
              required:
              - singleCount
              - bizType
            example:
              bizType: 13
              modelVersion: ''
              singleCount: 5
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      consumeQuantity:
                        type: number
                        description: 消费点数
                        examples:
                        - '30'
                      rightsType:
                        type: string
                        description: 权益类型
                        examples:
                        - InspirationCreativePoint
                      canUse:
                        type: boolean
                        description: 是否可以使用
                        examples:
                        - 'true'
                      unusableReason:
                        type: string
                        description: 不可用原因
                        examples:
                        - ' '
              example:
                msg: 成功
                code: 0
                data:
                  rightsType: InspirationCreativePoint
                  consumeQuantity: 30
                  canUse: true
                  unusableReason: ' '
                success: true
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/aiRoomDesign:
    post:
      operationId: apiRenderAiRoomDesign
      summary: AI空间设计
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=853284256691142751
      x-documentation-category: 玄尺AI / AI设计
      description: AI 空间设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                images:
                  type: array
                  items: {}
                  description: 空间设计图片列表,原始图放第一张，产品图放后面
              required:
              - images
            example:
              images: []
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      info:
                        type: string
                        description: 生成信息
                      taskId:
                        type: string
                        description: 任务ID
              example:
                msg: ''
                code: 0
                data:
                  taskId: ''
                  info: ''
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/backgroundPaint:
    post:
      operationId: apiRenderBackgroundPaint
      summary: 背景图重绘
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=726032261073490012
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  description: 提示词
                  examples:
                  - 现代风格
                initImage:
                  type: string
                  description: 原图
                  examples:
                  - https://xxx.com/xxx.jpg
                maskImage:
                  type: string
                  description: 遮罩图
                  examples:
                  - https://xxx.com/xxx.jpg
                batchCount:
                  type: integer
                  format: int32
                  description: 出图张数，默认1
                  examples:
                  - '1'
              required:
              - initImage
              - maskImage
            example:
              initImage: https://xxx.com/xxx.jpg
              batchCount: 1
              prompt: 现代风格
              maskImage: https://xxx.com/xxx.jpg
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      info:
                        type: string
                        description: 生成信息
                        examples:
                        - 任务已发送至队列中
                      taskId:
                        type: string
                        description: 任务ID
                        examples:
                        - 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
              example:
                msg: 成功
                code: 0
                data:
                  taskId: 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
                  info: 任务已发送至队列中
                success: true
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/bricksChange:
    post:
      operationId: apiRenderBricksChange
      summary: 产品替换-换砖
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=725393727069241376
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                templateId:
                  type: integer
                  format: int64
                  description: 渲染模板配置ID。见文档：https://help.3vjia.com/doc/open_doc/456823276459593731/723925629921284207
                  examples:
                  - '649971879238631495'
                extraParams:
                  type: object
                  description: '扩展信息。分辨率：aspectRatio。示例：{"aspectRatio": "1536x1024"}'
                sourceImageUrl:
                  type: string
                  description: 原图片
                replaceTarget:
                  type: string
                  description: 区域
                  examples:
                  - 地板
                  default: 地板
                products:
                  type: array
                  items:
                    type: object
                    properties:
                      imageUrl:
                        type: string
                        description: 产品图片
                    required:
                    - imageUrl
                  description: 产品信息列表
                prompt:
                  type: string
                  description: 提示语
                modelVersion:
                  type: string
                  default: i_o_2
              required:
              - extraParams
              - sourceImageUrl
              - products
            example:
              modelVersion: ''
              extraParams: ''
              templateId: 649971879238631495
              products:
              - imageUrl: ''
              replaceTarget: 地板
              sourceImageUrl: ''
              prompt: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      info:
                        type: string
                        description: 生成信息
                        examples:
                        - 任务已发送至队列中
                      taskId:
                        type: string
                        description: 任务ID
                        examples:
                        - 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
              example:
                msg: 成功
                code: 0
                data:
                  taskId: 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
                  info: 任务已发送至队列中
                success: true
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/changeMaterial:
    post:
      operationId: apiRenderChangeMaterial
      summary: 产品替换-换材质
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=725378201261588550
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                extraParams:
                  type: object
                  description: '扩展信息，分辨率：aspectRatio。示例：{     "aspectRatio": "1536x1024"   }'
                  examples:
                  - '{     "aspectRatio": "1536x1024"   }'
                sourceImageUrl:
                  type: string
                  description: 原图片
                products:
                  type: array
                  items:
                    type: object
                    properties:
                      imageUrl:
                        type: string
                        description: 材质图片
                        examples:
                        - https://xxx.com/xxx.jpg
                      selectedLabels:
                        type: array
                        items: {}
                        description: 替换的目标标签。如：地砖
                        examples:
                        - 地砖
                    required:
                    - imageUrl
                    - selectedLabels
                prompt:
                  type: string
                  description: 提示词
                  default: ' '
              required:
              - extraParams
              - sourceImageUrl
            example:
              extraParams: ''
              products:
              - imageUrl: https://xxx.com/xxx.jpg
                selectedLabels: []
              sourceImageUrl: ''
              prompt: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      info:
                        type: string
                        description: 生成信息
                        examples:
                        - 任务已发送至队列中
                      taskId:
                        type: string
                        description: 任务ID
                        examples:
                        - 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
              example:
                msg: 成功
                code: 0
                data:
                  taskId: 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
                  info: 任务已发送至队列中
                success: true
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/checkProductWhiteBg:
    post:
      operationId: apiRenderCheckProductWhiteBg
      summary: 商品白底图合格检测
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=827234429176025105
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                imageUrl:
                  type: string
                  description: 商品白底图URL
              required:
              - imageUrl
            example:
              imageUrl: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      result:
                        type: string
                        description: 检测结果
                      reason:
                        type: array
                        items: {}
                        description: 原因列表
              example:
                msg: ''
                code: 0
                data:
                  reason: []
                  result: ''
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/comfyCommon:
    post:
      operationId: apiRenderComfyCommon
      summary: 空间填充3.0
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=791370289819828290
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                batchCount:
                  type: integer
                  format: int32
                  description: 出图数量,默认是1张
                  default: '1'
                initImage:
                  type: string
                  description: 初始图片
                prompt:
                  type: string
                  description: 提示词
                extImageUrls:
                  type: array
                  items: {}
                  description: 扩展图片，当前任务支持传递1张风格参考图
              required:
              - initImage
            example:
              initImage: ''
              batchCount: 0
              extImageUrls: []
              prompt: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      info:
                        type: string
                        description: 生成信息
                      taskId:
                        type: string
                        description: 任务ID
              example:
                msg: ''
                code: 0
                data:
                  taskId: ''
                  info: ''
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/comfyTextureChangeV2:
    post:
      operationId: apiRenderComfyTextureChangeV2
      summary: 产品替换-换墙涂料2.0
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=725383989417889891
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                extraParams:
                  type: object
                  description: '扩展信息。分辨率：aspectRatio。示例：{     "aspectRatio": "1536x1024"   }'
                sourceImageUrl:
                  type: string
                  description: 原图片
                  examples:
                  - https://xxx.com/xxx.jpg
                products:
                  type: array
                  items:
                    type: object
                    properties:
                      imageUrl:
                        type: string
                prompt:
                  type: string
                  description: 提示词
              required:
              - extraParams
            example:
              extraParams: ''
              products:
              - imageUrl: ''
              sourceImageUrl: https://xxx.com/xxx.jpg
              prompt: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      info:
                        type: string
                        description: 生成信息
                        examples:
                        - 任务已发送至队列中
                      taskId:
                        type: string
                        description: 任务ID
                        examples:
                        - 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
              example:
                msg: 成功
                code: 0
                data:
                  taskId: 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
                  info: 任务已发送至队列中
                success: true
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/comfyTextureChangeV3:
    post:
      operationId: apiRenderComfyTextureChangeV3
      summary: 换墙涂料3.0
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=791009915224346764
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                initImage:
                  type: string
                  description: 初始图片
                  examples:
                  - https://3vj-innovation.3vjia.com/demo/tree31_2.png
                styleImage:
                  type: string
                  description: 涂料图
                  examples:
                  - https://3vj-innovation.3vjia.com/demo/tree_p.png
                reduce:
                  type: integer
                  format: int32
                  description: 值：0/1，是否缩小纹理，适用于粗糙纹理和无缝纹理，默认是0，即不缩小纹理；
                  examples:
                  - '0'
            example:
              reduce: 0
              initImage: https://3vj-innovation.3vjia.com/demo/tree31_2.png
              styleImage: https://3vj-innovation.3vjia.com/demo/tree_p.png
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      info:
                        type: string
                        description: 生成信息
                      taskId:
                        type: string
                        description: 任务ID
              example:
                msg: ''
                code: 0
                data:
                  taskId: ''
                  info: ''
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/comfyTextureChangeV4:
    post:
      operationId: apiRenderComfyTextureChangeV4
      summary: 换墙涂料4.0
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=801812575007424611
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                initImage:
                  type: string
                  description: 初始图片
                  examples:
                  - https://3vj-innovation.3vjia.com/demo/tree31_2.png
                styleImage:
                  type: string
                  description: 场景图
                  examples:
                  - https://3vj-innovation.3vjia.com/demo/tree_p.png
                expand:
                  type: integer
                  format: int32
                  description: 值：0/1，是否扩大纹理，（细腻纹理和非无缝纹理选择expand=1)，默认是0，即不扩大纹理
                  examples:
                  - '0'
                light:
                  type: integer
                  format: int32
                  description: 值：0/1，是否提亮环境，（需要提升图片亮度选择light=1)，默认是0，即不提亮
                  examples:
                  - '0'
                clean:
                  type: integer
                  format: int32
                  description: 值：0/1，是否去除漆病污点，（不处理墙面选择clean=0)，默认是1，即处理墙面漆病
                  examples:
                  - '0'
            example:
              initImage: https://3vj-innovation.3vjia.com/demo/tree31_2.png
              styleImage: https://3vj-innovation.3vjia.com/demo/tree_p.png
              clean: 0
              expand: 0
              light: 0
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      info:
                        type: string
                        description: 生成信息
                      taskId:
                        type: string
                        description: 任务ID
              example:
                msg: ''
                code: 0
                data:
                  taskId: ''
                  info: ''
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/countertopChange:
    post:
      operationId: apiRenderCountertopChange
      summary: 产品替换-换台面
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=725397578988011578
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                extraParams:
                  type: object
                  description: '扩展信息。分辨率：aspectRatio。示例：{"aspectRatio": "1536x1024"}'
                sourceImageUrl:
                  type: string
                  description: 原图片
                  examples:
                  - https://xxx.com/xxx.jpg
                products:
                  type: array
                  items:
                    type: object
                    properties:
                      imageUrl:
                        type: string
                        description: 产品图片
                        examples:
                        - https://xxx.com/xxx.jpg
                    required:
                    - imageUrl
                  description: 产品列表信息
                prompt:
                  type: string
                  description: 提示词
              required:
              - extraParams
              - sourceImageUrl
              - products
            example:
              extraParams: ''
              products:
              - imageUrl: https://xxx.com/xxx.jpg
              sourceImageUrl: https://xxx.com/xxx.jpg
              prompt: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      info:
                        type: string
                        description: 生成信息
                        examples:
                        - 任务已发送至队列中
                      taskId:
                        type: string
                        description: 任务ID
                        examples:
                        - 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
              example:
                msg: 成功
                code: 0
                data:
                  taskId: 0bc2b9b6-3b4e-4c5b-a490-4aaaf4e81416
                  info: 任务已发送至队列中
                success: true
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/render/doorChange:
    post:
      operationId: apiRenderDoorChange
      summary: 产品替换-换门
      tags:
      - Xuanchi AI
      x-source-documentation: https://dev.3vjia.com/document?apiId=725396320654868527
      x-documentation-category: 玄尺AI / AI设计
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                changeType:
                  type: string
                  description: 替换类型：change_door_material 替换材质；change_door 替换造型和材质；默认：change_door
                  examples:
                  - change_door
                  default: change_door
                extraParams:
                  type: object
                  description: '扩展信息。分辨率：aspectRatio。示例：{"aspectRatio": "1536x1024"}'
                sourceImageUrl:
                  type: string
                  description: 原图
                  examples:
                  - https://xxx.com/xxx.jpg
                replaceTarget:
                  type: string
                  description: 替换目标
                  examples:
                  - 衣柜
                products:
                  type: array
                  items:
                    type: object
                    properties:
                    

# --- truncated at 32 KB (133 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/openapi/3vjia-technology-xuanchi-ai-api-openapi.yml