Postman Collections

Quickly explore and integrate KonPro APIs using our ready-made Postman collection.

The KonPro API Postman collection is designed to help you test and interact with the KonPro API directly in Postman without having to write extra boilerplate code. Postman is a popular platform for API testing and workflow automation that allows you to send requests, view responses, and manage your API usage efficiently.

Importing the KonPro Collection

  1. 1Open the KonPro API Postman collection link.
  2. 2Click Run in Postman.
  3. 3Choose whether to continue in the Postman web app or the desktop app.
  4. 4Select your workspace to import the collection and its environment variables.

Setting Up Your Environment

  1. 1In Postman, go to the Environments tab on the left-hand sidebar.
  2. 2Locate and select the KonPro API Environment.
  3. 3Update the konpro-api-key field with your current API key from the KonPro dashboard.
  4. 4Ensure that KonPro API Environment is set as the active environment via the environment selector in the top-right of Postman.

How It Helps

Using the KonPro Postman collection streamlines key tasks such as:

  • Generating avatar videos with POST /v1/avatar_videos
  • Fetching video templates via GET /v1/templates
  • Translating videos into other languages using POST /v1/video_translate
  • Connecting to real-time avatar streaming with WS /v1/streaming/connect

This saves time by giving you pre-configured request examples with authentication already built-in, letting you focus on testing and development instead of setup.

Rate Limits and Errors

API requests are subject to rate limits to maintain service stability.

Each response includes rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset).

Common error codes include:

  • 400– Bad request (invalid parameters or JSON)
  • 401– Unauthorized (invalid or missing API key)
  • 429– Too many requests (rate limit exceeded)
  • 500– Internal server error

SDKs and Libraries

Postman is a great way to test and prototype, but for production, you can also use official SDKs:

Python

pip install konpro-sdk

JavaScript (Node.js & Browser)

npm install @konpro/sdk

PHP

composer require konpro/sdk

Go

go get github.com/konpro/sdk-go

By combining the Postman collection with KonPro's SDKs, you can seamlessly move from testing to full-scale integration.

Table of Contents