# 1. API Overview

This document is intended for external clients integrating Growth Studio's video generation capabilities on the server side.

Quick facts

The production domain is provided by Growth Studio. Use HTTPS directly; do not send an HTTP request first and then follow a redirect.

Available endpoints

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 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 begin with mh_live_. They are generated in the Growth Studio console and associated with a specific account and workspace.

Every request must include:

Authorization: Bearer <API_KEY>