1. API Overview

This document is intended for external clients integrating with Marketing Hub's video generation capabilities from a server.

The production domain is provided by Marketing Hub. Use HTTPS directly; do not make an HTTP request first and then follow a redirect.

The following endpoints are currently available:

Method Path Description
GET /openapi/v1/avatars Get system Avatar list
POST /openapi/v1/image/upload Upload a product or custom Avatar image
POST /openapi/v1/videos Create video generation task
GET /openapi/v1/videos/{video_id} Get video details and generation results
POST /openapi/v1/videos/{video_id}/edit Initiate an Agent video clip replacement task
GET /openapi/v1/videos List videos using cursor-based pagination

This version does not provide webhooks. After creating a video, poll the video details endpoint to obtain the final result.

2. Authentication and Request Conventions

2.1 API Key

Production API keys start with mh_live_. They are generated in the Marketing Hub console and bound to a specific account and workspace.

Every request must include:

Authorization: Bearer <API_KEY>

Example:

export BASE_URL='<https://growth-api.pixverse.ai>'
export API_KEY='mh_live_REPLACE_WITH_PRODUCTION_API_KEY'

Security requirements: