Growth Studio OpenAPI Integration Guide

1. API Overview

This document is intended for external clients integrating Growth Studio's video generation capabilities through a server-side application.

API version: v1
Production Base URL: https://growth-api.pixverse.ai
Base Path: /openapi/v1
Authentication: Bearer API Key
Request and response encoding: UTF-8
JSON timestamp format: ISO 8601 UTC

The production domain is provided by Growth Studio. Use HTTPS directly. Do not send a request over HTTP and then follow a redirect.

The following endpoints are currently available:

Method	Path	Description
`POST`	`/openapi/v1/image/upload`	Upload a product image or custom avatar image
`POST`	`/openapi/v1/videos`	Create a video generation job
`GET`	`/openapi/v1/videos/{video_id}`	Retrieve video details and generation results
`GET`	`/openapi/v1/videos`	List videos using cursor-based pagination

The current version does not support 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 begin with mh_live_. They are generated in the Growth Studio admin console and associated with 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: