调用示例

本地示例工作台

把能力,
接进你的下一步。

从真实的任务结构出发,看清一次调用如何进入系统,又如何把结果带回业务。

选择一个场景

design.generate

把设计要求,交给生成能力。

将产品类型、造型方向与材料要求整理成输入。在你的设计工具中创建任务,再把生成结果接回方案评审。

本地演示

示例协议 · 接入时以约定版本为准。播放过程不发送网络请求。

01构建请求
POST /v1/tasks
{
  "capability": "design.generate",
  "input": {
    "prompt": "Design an elegant electric GT in liquid silver, with a low silhouette and a dark panoramic roof.",
    "constraints": {
      "view": "front_three_quarter",
      "material": "satin_metal",
      "background": "dark_studio"
    }
  },
  "output": {
    "format": "png"
  }
}
输入

自然语言要求 + 材料与视角条件

02读取结果input

组织输入

将设计意图整理成明确条件。

{
  "capability": "design.generate",
  "input_checks": [
    "prompt_present",
    "view_supported",
    "format_supported"
  ]
}
输出

图像资产 + 可追踪的任务结果

一次调用,完整看懂。

播放过程,或点选任一步骤查看。

将设计意图整理成明确条件。

产品、比例、材料与视角分别传入。前端可来自一次对话,也可来自现有设计表单。

代码之外,
还有业务的上下文。

接入能力,是把模型的输入和结果放进你的系统。场景不同,需要保留的条件、来源和验收方式也不同。

01

条件随项目保存

把本轮输入与结果一起存档。下一轮修改沿用已有要求,避免只保留一张与上下文脱离的图片。

02

生成与评审分层

模型生成概念表达;可制造性、精确尺寸与结构仍由后续设计和工程流程验证。

03

资产进入你的系统

在约定的访问周期内读取结果,关联项目与版本,再按业务规则展示给用户。

带走一个清楚的起点

请求、结果与过程,
一起带回你的项目。

下载当前场景的 JSON 示例包,包含请求结构、响应样例与流程说明。适合与团队讨论接口约定,或作为前端联调的本地样例。

design.generate当前场景
  • request输入与参数
  • response结果样例
  • walkthrough执行步骤
  • curl调用写法

本地示例文件;模型服务和三维资产文件另行接入。

每一种状态,
都给业务一个下一步。

结果与异常参考
INVALID_INPUT

修改输入,再创建任务。

明确指出缺少的字段或不支持的格式。用户修正输入后,才进入下一次调用。

ACCESS_DENIED

核对权限,不重复尝试。

区分调用凭证和资产访问授权。把来源不可读取的问题留在接入层解决。

POLLING_TIMEOUT

保留任务,稍后继续观察。

本地等待结束不代表服务端任务失败。使用已有任务标识查询,避免重复生成。

错误码名称为本页示例;正式处理逻辑以接入协议为准。

从理解调用,到完成接入。

继续阅读开发文档带着你的场景来
鲁ICP备2024109755号-2
可拖动移动。右键、长按或按 Shift+F10 可选择停靠位置。