Mavowow OpenAPI

OpenAPI商品图片与视频生成接口

Mavowow API 为电商工具与内容团队提供图片和视频生成接口。把商品画面、场景编辑与视频素材的创作,接入你自己的系统。

专为电商而生 · 由你的系统组织创作流程

创建图片任务REST
POST /openapi/v1/images/generations
{
  "model": "gpt-image-2",
  "mode": "generate",
  "prompt": "Studio headphones, soft light",
  "size": "1K",
  "aspect_ratio": "1:1"
}

201 Created · queued 示例响应

耳机商品的棚拍展示示意耳机商品的生活场景展示示意
商品图示意

按创作任务,选择合适的模型

  • GPT Image 2
  • Nano Banana 2
  • Nano Banana Pro
  • Seedream 5.0
  • Qwen Image 2.0
  • Midjourney V7 Imagine
  • Seedance 2.0
  • Grok Video 3

可用模型与参数以模型列表接口返回为准。 GET /openapi/v1/models

商品视觉生产

一件商品,多种视觉表达

从新品画面到场景变化,再到视频素材,围绕商品安排每一次创作。各项输入与输出规格由所选模型决定。

耳机商品的棚拍展示示意商品图示意

构思商品画面

描述商品、构图与光线,为上新和营销探索画面。

POST /openapi/v1/images/generations
耳机商品的棚拍展示示意耳机商品的生活场景展示示意
商品图示意

延展现有素材

提供商品参考图,按模型能力调整场景、风格或画面细节。

mode: edit
香水商品视频的场景预览示意商品图示意

探索动态展示

用文字或参考素材描述镜头,为商品展示制作视频素材。

POST /openapi/v1/videos/generations

从一次商品创作,跑通接入

先用一件商品验证输入、任务状态与结果保存,再由你的系统编排后续创作。

阅读接入指南
  1. 创建并保存 API Key

    完整密钥仅显示一次,请保存到服务端环境变量或密钥管理系统。

  2. 设定这次创作

    根据商品画面选择模型,填写提示词与参考素材;为每个新任务设置唯一 Idempotency-Key,并保存任务 ID。

  3. 把结果交回你的系统

    按建议间隔轮询,任务完成后及时转存结果;图片与视频的审核、整理和后续使用由你的业务流程安排。

看看一张商品图如何发起请求

下面以耳机商品画面为例:指定模型、提示词和输出规格后,接口先返回任务 ID,再通过轮询获取结果。这是 Mavowow 的异步任务接口,不直接替代 OpenAI SDK。

创建图片任务curl · REST
curl -X POST \
  'https://open-api.mavowow.com/openapi/v1/images/generations' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: 4e4be4c5-4c59-48ef-893b-f9419af9f8e8' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "mode": "generate",
    "prompt": "Studio headphones, soft light of a headphones",
    "size": "1K",
    "aspect_ratio": "16:9"
  }'

# 201 Created
{
  "data": {
    "id": d2b22844-...",
    "status": queued",
    "model": gpt-image-2"
  }
}

创作入口不同,账户规则一致

会员与积分共用
沿用网页端的会员、积分与价格规则,API 不提供独立额度。
任务共享并发
与网页端共用任务并发额度;超过并发不会扣费。
失败按规则退款
供应方最终失败时按现有规则退款,可核对 usage.points_refunded。
API 任务独立查询
仅查询本账户的 OpenAPI 任务,不读取网页端私人提示词历史。

接入之前,先理清这些事

从商品素材、团队流程到任务计费,了解 API 的使用边界。

你可以从商品画面的文字描述开始生成图片,使用参考图进行编辑,或调用视频模型制作素材。具体输入、编辑方式与输出规格取决于所选模型;API 返回创作结果,上架、发布和审核由你的系统完成。

下一次上新,从你的系统开始

把商品画面的创作,接入你熟悉的产品与运营流程。