Mavowow OpenAPI

OpenAPIProduct image & video generation API

Mavowow API is for ecommerce tools and content teams. Call image and video models from your server to bring product imagery, scene edits and video assets into your own systems.

Create API keyView API reference

Purpose-built for ecommerce · Your system controls the creative workflow

Create an image taskREST
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 Example response

Studio product image of headphonesLifestyle product image of headphones
Product image examples

Choose a model for the creative task

  • 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

Available models and parameters are defined by the live model catalog. GET /openapi/v1/models

Product visual production

One product. More ways to show it.

Plan each creative task around your product, from launch imagery and new settings to video assets. Inputs and output specifications depend on the chosen model.

Studio product image of headphonesProduct image examples

Create a product scene

Describe the product, composition and lighting to explore imagery for launches and campaigns.

POST /openapi/v1/images/generations
Studio product image of headphonesLifestyle product image of headphones
Product image examples

Build on existing imagery

Supply a product reference image and adjust scenes, styles or details within the model’s capabilities.

mode: edit
Scene preview from a perfume product videoProduct image examples

Explore product motion

Describe a shot with text or reference media to create video assets for product presentations.

POST /openapi/v1/videos/generations

Start with one product creative task

Validate inputs, task status and result storage with one product, then orchestrate further creative tasks in your system.

Read the integration guide

  1. Create and save your API key

    The full key is shown once. Save it in server-side environment variables or a secret manager.

  2. Define the creative task

    Choose a model for the product scene and supply a prompt and supported reference media. Use a unique Idempotency-Key for each new task and save its ID.

  3. Bring results back to your system

    Poll at the recommended interval and copy completed results to your storage. Your workflow handles review, organization and subsequent use.

See how a product image request starts

This headphone scene example specifies a model, prompt and output format. The API returns a task ID; poll to retrieve the result. Mavowow uses an asynchronous task API, not a drop-in replacement for the OpenAI SDK.

Create an image taskcurl · 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"
  }
}

Different creative entry points. One account.

Shared membership & credits
Existing membership, credit and pricing rules apply. API calls have no separate allowance.
Shared task concurrency
API and web tasks share concurrency limits. Exceeding them does not charge credits.
Refunds follow existing rules
Final provider failures are refunded under existing rules. Check usage.points_refunded.
API task queries stay separate
Query only this account’s OpenAPI tasks, without accessing private web prompt history.

Before you connect

Understand product inputs, team workflows and task billing before integrating.

Generate images from a product scene description, edit with reference images or call video models to create assets. Inputs, editing options and output formats depend on the chosen model. The API returns creative results; your system handles review, listing and publishing.

Start your next launch in your own system

Connect product imagery creation to the tools and operations you already use.

Create API keyView API reference