AI营销商品图

OpenAPI Specification

接口：POST /volcv/v1（完整地址 https://api.allyang.cn/volcv/v1）

鉴权：请求头 Authorization: Bearer {{YOUR_API_KEY}}（原文标注为可选）。

查询参数

Action：必填，string，取值示例 CVProcess。
Version：必填，string，取值示例 2022-08-31。

请求头

Authorization：可选，string，默认值 Bearer {{YOUR_API_KEY}}。

请求体参数（application/json）

原文 schema 未声明任何请求体字段（properties: {}），仅给出示例；示例字段有二十余个，例如 req_key（示例值 img2img_e_commerce_style）、product_image_input、ref_image_input、canvas_width、canvas_height、seed（示例值 -1）、positive_prompt、return_url，以及水印对象 logo_info（内含 add_logo、opacity、logo_text_content 等）。
因 schema 为空，各字段的类型、必填性与默认值原文均未给出，待补。

请求体示例字段（原文档未声明各字段类型与必填性，待补）

req_key、product_image_input、ref_image_input、product_alpha_switch、mask_invert_switch、auto_composition_switch、canvas_width、canvas_height、auto_offset_x、auto_offset_y、auto_scale、product_weight、ref_switch、ref_weight、ref_end_at、seed、positive_prompt、preset_light_switch、light_position、upload_light_switch、product_safe_switch、product_edge_weight、return_url，以及水印对象 logo_info（含 add_logo、position、language、opacity、logo_text_content）。

响应

200：成功；响应体字段结构原文未给出，待补。

补充：本接口面向营销物料场景做商品图合成，请求字段较多而原文档未给出类型声明；接入前建议先在测试环境确认字段组合，示例里的商品图地址与水印文案均为占位值，请替换为自己的资源。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。