ZenCreator API

Developer guide

What Is the ZenCreator Public API?

The ZenCreator Public API is a developer interface for creating AI-generated media through code. Instead of using only the ZenCreator dashboard, developers can call API endpoints to upload assets, list available tools, start generations, check progress, and download results.

ZenCreator’s public documentation also provides machine-readable resources for AI agents, MCP clients, and code generators, including an OpenAPI JSON specification and a SKILL.md file.

AI image generation

AI video generation

Image-to-video workflows

Lip sync generation

Face workflows

Image upscaling

Video upscaling

Creative automation

AI agent integrations

Internal business tools

Separate concepts

Public API vs API Keys

Use the Public API documentation to understand endpoints, request formats, tools, schemas, rate limits, and workflow. Use the API Keys page to create and manage the secure key required to authenticate requests.

Area	What It Does	Best For
Public API	Lets developers call ZenCreator tools through code.	Apps, automations, websites, agents, and backend workflows.
API Keys	Gives secure access credentials for API authentication.	Connecting your ZenCreator account to API requests.
Public API Docs	Shows endpoints, request formats, tools, schemas, rate limits, and workflow.	Developers building integrations.
API Keys Page	Lets signed-in users create and manage API keys.	Account owners and technical users.

Open Public API Docs Manage API Keys

Build with ZenCreator

What You Can Build With ZenCreator API

Use the API when you need repeatable image or video generation, controlled backend workflows, batch creative production, or AI generation inside your own product.

AI image generation apps

Build tools that create product images, social visuals, thumbnails, campaign graphics, concept art, and creative assets from prompts.

AI video generation workflows

Generate videos from prompts, images, reference assets, or structured creative instructions.

Image-to-video automation

Turn product photos, campaign images, avatar visuals, or social graphics into motion-based content.

Upscaling tools

Improve image or video clarity before publishing content on websites, ecommerce pages, social media, or client campaigns.

Lip sync workflows

Create presenter-style or talking-style videos from approved assets and proper consent-based use.

Ecommerce creative systems

Generate product visuals, product ads, product videos, lifestyle scenes, or upscaled assets from product catalogs.

AI agent workflows

Connect ZenCreator tools to AI agents, MCP clients, internal assistants, or developer copilots.

Batch creative production

Use structured prompts, product lists, or campaign briefs to generate multiple creative assets more efficiently.

Async workflow

How ZenCreator API Works

ZenCreator generations are asynchronous. That means the API does not always return the final image or video immediately. Start the job, check its status, then fetch the result when it is ready.

Create API Key

Create an API key

Sign in to ZenCreator and create an API key from the API Keys page.

Authenticate with Bearer token

Send the API key in the request header as a Bearer token.

List available tools

Use the API to list tools and read each tool input_schema for required fields, allowed values, and defaults.

Start a generation

Send a generation request with the selected tool name and input data.

Poll the generation status

Check the generation status until the job is complete or reaches a final state.

Fetch the output

After the generation is complete, fetch the result and use it in your app, workflow, or content system.

API access points

Base URL and Endpoints

Use the current public API base URL and v1 endpoint prefix for public API requests.

https://api.zencreator.pro

/api/public/v1

https://api.zencreator.pro/api/public/openapi.json

Quick example

Basic API Workflow Example

# 1. List tools
curl "https://api.zencreator.pro/api/public/v1/tools" \
  -H "Authorization: Bearer $ZC_API_KEY"

# 2. Start a generation
curl -X POST "https://api.zencreator.pro/api/public/v1/generations" \
  -H "Authorization: Bearer $ZC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "by_prompt",
    "input": {
      "positive_prompt": "premium skincare product photo, soft studio lighting, clean background",
      "ratio": "1:1"
    }
  }'

# 3. Check generation status
curl "https://api.zencreator.pro/api/public/v1/generations/{id}" \
  -H "Authorization: Bearer $ZC_API_KEY"

# 4. Fetch result
curl "https://api.zencreator.pro/api/public/v1/generations/{id}/result" \
  -H "Authorization: Bearer $ZC_API_KEY"

API keys

API Keys: What They Are and How to Use Them

An API key is a private access credential that lets your app authenticate with ZenCreator API. Treat API keys like passwords. Do not publish them in frontend JavaScript, GitHub repositories, public documents, screenshots, browser code, or client-side apps.

Sign in to your ZenCreator account.
Open the API Keys page.
Create a new key.
Copy the key when it is shown.
Store it securely in your backend, environment variables, or secret manager.

Open API Keys

API Key Scopes

Scope	Purpose
`read`	List tools, poll generations, and read transactions.
`generate`	Start generations and upload assets.

Authorization: Bearer zc_live_your_key_here

Uploading Files

Some tools need an image, video, or audio input. For those workflows, upload the source file first, then use the returned asset ID in a generation request. The Public API supports asset uploads using multipart/form-data and accepts a media_type and file. The documented max upload size is 50 MB.

Credits and Billing

ZenCreator API uses credits for generations. Exact prices can vary based on tool, model, duration, resolution, number of outputs, or other input choices. Transaction history records the exact amount charged, and credits are automatically refunded if a generation fails.

View Pricing

Rate Limits

ZenCreator API includes rate limits to protect service quality and stability. The public documentation lists limits over a 60-second sliding window, including separate limits for read requests, generation requests, and asset uploads. Responses include rate limit headers such as X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

Avoid unnecessary polling.
Use reasonable retry logic.
Respect Retry-After headers.
Queue large batch jobs.
Handle temporary failures gracefully.

Use cases

Best Use Cases for ZenCreator Public API

Use ZenCreator API when you want controlled, repeatable creative generation inside your own apps, systems, or agent workflows.

Developer apps

Add AI image or video generation into your own app, dashboard, SaaS platform, or internal tool.

Ecommerce automation

Generate product visuals, lifestyle images, product videos, upscaled assets, and social ads from product data.

Marketing campaigns

Create batches of creative assets from briefs, campaign calendars, ad concepts, or landing page requirements.

AI agents and MCP clients

Connect ZenCreator generation tools into AI assistants, developer agents, and MCP workflows.

Content platforms

Allow users to generate thumbnails, short videos, images, avatars, visual posts, and creative assets.

Agency workflows

Build repeatable asset-generation systems for client campaigns, product launches, and social content.

Internal creative tools

Create private tools for your team to generate brand-safe content with controlled prompts and approved workflows.

API or MCP

Public API and MCP: Which Should You Use?

For developer applications, use the Public API. For agent-driven creative workflows, use ZenCreator MCP.

Choose Public API If	Choose MCP If
You are building an app or backend integration.	You want an AI client to use ZenCreator tools.
You need direct control over endpoints and logic.	You want Claude, ChatGPT, Cursor, or Claude Code to drive creation.
You want to manage your own UI and workflow.	You want agent-driven workflows.
You are building production automation.	You want natural-language tool use.
You need structured API responses.	You want a faster setup for AI assistants.

Explore ZenCreator MCP Server

Security

Security Best Practices for API Keys

Keep keys server-side

Do not put API keys in frontend JavaScript, public GitHub repositories, or mobile app bundles.

Use environment variables

Store keys in .env files, hosting secrets, or secure environment variables.

Limit key scopes

Use the minimum scope required for each project.

Rotate keys when needed

Create a new key and remove old keys if a key is exposed or no longer used.

Separate keys by project

Use different API keys for different apps, environments, or team workflows.

Monitor usage

Check transactions, credit usage, and generation activity regularly.

Responsible use

Content Safety

Before uploading, generating, publishing, or distributing content, make sure you have the rights and permissions for any images, videos, faces, voices, logos, product assets, brand materials, prompts, or user-uploaded files involved.

Review outputs before ads, ecommerce, client work, or public campaigns.
Check people, faces, or likeness-based content carefully.
Do not create misleading, harmful, non-consensual, unlawful, exploitative, or rights-violating content.

Developer tips

Tips for Better API Integration

Start with one tool

Before building a large workflow, test one tool, one request, and one expected output.

Read the input schema

Use the tool’s input schema to understand required fields, allowed values, defaults, and model choices.

Design for async jobs

Build your app around queued jobs, status polling, and result fetching.

Add error handling

Handle insufficient credits, invalid inputs, failed generations, rate limits, expired assets, and temporary service issues.

Log generation IDs

Save generation IDs so you can check status, debug issues, and connect outputs to user actions.

Use short tests first

When testing video or complex media workflows, start with small jobs before scaling.

Keep prompts structured

Use clear prompts with subject, style, ratio, lighting, motion, quality goal, and final use case.

Review outputs before publishing

AI-generated content should be reviewed before public or commercial use.

FAQ

ZenCreator API Questions

ZenCreator API is a public developer API that gives programmatic access to ZenCreator AI generation tools such as image generation, video generation, upscaling, face workflows, and lip sync.

It is used to build apps, workflows, automations, websites, AI agents, and internal tools that create or process AI-generated media.

Sign in to ZenCreator and open the API Keys page. Create a key, copy it when shown, and store it securely.

Send your API key in the request header as a Bearer token, such as Authorization: Bearer zc_live_your_key_here.

Not always. Generations are asynchronous. You start a generation, poll its status, and fetch the output when it is ready.

Yes. The API supports file uploads for workflows that need source assets, with supported image, video, and audio media types documented in the public API docs.

Yes. The Public API provides programmatic access to video generation and related tools.

Yes. The documentation provides resources for AI agents, MCP clients, and code generators, including OpenAPI JSON and SKILL.md.

Yes. Generations use credits. Pricing may vary by tool, model, duration, resolution, and output count, and exact charges are recorded in transaction history.

The Public API documentation states that credits are automatically refunded if a generation fails.

No. Keep API keys private and server-side. Treat them like passwords.

Related pages

Explore More ZenCreator Developer and AI Tools

Use these internal resources to connect API workflows with ZenCreator tools, prompts, pricing, and MCP setup.

ZenCreator MCP Server AI Video Generator AI Video Upscaler AI Image Generator Image to Video AI AI Lip Sync Generator AI Models Pricing AI Video Prompts AI Upscaler Prompts Tools Responsible AI Commercial Use

Start building

Build AI Image and Video Workflows With ZenCreator API

Use ZenCreator Public API to connect AI image generation, video generation, upscaling, lip sync, and creative tools to your app, website, workflow, or AI agent. Create an API key, read the public documentation, and start building with ZenCreator.

Get API Key Read Public API Docs Explore ZenCreator MCP