该接口支持调用豆包大模型中的智能生图 API 能力,并根据豆包模型请求信息生成相应的一张图片。同时您可指定 veImageX 的图片处理模板,对智能生成的图片进行进一步的个性化图片处理,获取同步输出的结果图。
本段主要介绍如何获取调用时的参数信息,以及获取后在本接口的具体传参位置。
ServiceId
、域名Domain
、模版配置Template
。ModelAction
、ModelVersion
和 ReqJson
这个三个参数的填写。Outputs
。下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetCVAnimeGenerateImage | 接口名称。当前 API 的名称为 GetCVAnimeGenerateImage 。 |
Version | String | 是 | 2023-05-01 | 接口版本。当前 API 的版本为 2023-05-01 。 |
ServiceId | String | 是 |
| 指定存储结果图并计量计费的服务 ID。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Domain | String | 是 |
| 服务下绑定的域名,域名状态需正常可用。 |
Template | String | 是 |
| 服务下创建的图片处理模板配置(不带~),指定后,将按照模板中的处理配置对豆包大模型生成的图片进行图片处理。 |
Outputs | Array of String | 是 |
| 指定输出图片的文件名,输入限制如下所示:
|
Overwrite | Boolean | 否 |
| 是否覆盖服务下同名文件,取值如下所示:
说明 请确保您已开启重名覆盖上传功能,否则,此处配置无效。 |
ModelAction | String | 是 |
| 文生图系列模型的接口 Action 名称。 |
ModelVersion | String | 是 |
| 文生图系列模型的接口 Version 名称。 |
ReqJson | JSON Map | 是 | 详见描述内取值示例 | 文生图系列模型的接口的请求 JSON 字符串。
说明 您可忽略 |
下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
ImageUrls | Array of String | ["http://test.example.cn/demo1~tplv-serviceid-image.image"] | 最终上传至 veImageX 服务的结果图访问 URL,数量为 1。 |
RespJson | JSON Map | 详见描述内取值示例 | 根据指定的文生图模型接口信息,接收的该接口响应的 JSON 数据。
|
StoreUris | Array of String | ["tos-cn-i-serviceid/demo1"] | 最终上传至 veImageX 服务的结果图存储 URI,数量为 1。 |
POST https://imagex.volcengineapi.com/?Action=GetCVAnimeGenerateImage&Version=2023-05-01&ServiceId=serviceid { "Domain": "test.example.com", "Template": "tplv-serviceid-test.image", "Outputs": [ "demo1" ], "Overwrite": true, "ReqJson": { "req_key": "high_aes", "prompt": "千军万马", "model_version": "anime_v1.3", "image_urls": [ "http://test.example.com/a.png" ] }, "ModelAction": "CVProcess", "ModelVersion": "2022-08-31" }
{ "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "GetCVAnimeGenerateImage", "Version": "2023-05-01", "Service": "ImageX", "Region": "cn-north-1" }, "Result": { "RespJson": { "code": 10000, "data": { "binary_data_base64": [ "xxx" ] }, "message": "Success", "request_id": "20220926182941010212157201024017C6", "status": 10000, "time_elapsed": "456.790505ms" }, "ImageUrls": [ "http://test.example.cn/demo1~tplv-serviceid-image.image" ], "StoreUris": [ "tos-cn-i-serviceid/demo1" ] } }
本接口无特有的错误码。更多信息请见公共错误码和 veImageX 错误码。
veImageX 提供了配套的开发工具集 SDK,支持多种编程语言,帮助您更方便的调用 API。