API Documentation

Integrate iTeraBiz into your applications with our RESTful API

Quick Start

curl https://api.iterabiz.com/v1/avatars \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Introduction

The iTeraBiz API allows you to programmatically create avatars, generate content, and manage videos. All API requests must be authenticated using an API key.

Base URL:

https://api.iterabiz.com/v1

Authentication

Include your API key in the Authorization header of every request. You can generate API keys in your account dashboard.

Example:

Authorization: Bearer sk_live_abc123...

Avatars API

GET/avatars

Retrieve a list of all your avatars

{
  "data": [
    {
      "id": "avatar_abc123",
      "name": "Professional Avatar",
      "preview_url": "https://cdn.iterabiz.com/...",
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "has_more": false
}

POST/avatars

Create a new AI avatar

{
  "name": "My New Avatar",
  "image_url": "https://example.com/photo.jpg",
  "voice_id": "voice_xyz789"
}

Content Generation API

POST/content/generate

Generate video content using AI

{
  "prompt": "Create a product review video about...",
  "avatar_id": "avatar_abc123",
  "language": "en-US",
  "duration": 60
}

Video Jobs

Use the videos endpoints to inspect job status, list completed videos, and fetch downloadable results.

GET/videos

List video jobs for the current account

GET/videos/{id}

Retrieve the status and metadata for a single video job

POST/videos

Create a new video job from an avatar, script, language, and duration

{
  "avatar_id": "avatar_abc123",
  "script": "Create a product intro video...",
  "language": "en-US",
  "duration": 45
}

Webhooks

Video completed

Sent when rendering finishes successfully and the video is ready for download.

video.completed

Video failed

Sent when generation fails so your app can show a retry or support path.

video.failed

Common Errors

401

Missing or invalid API key.

422

Required parameters are missing or malformed.

429 / 500

Too many requests or the service is temporarily unavailable.

Rate Limits

• Free Plan: 100 requests/day
• Pro Plan: 1,000 requests/day
• Business Plan: 10,000 requests/day
• Enterprise: Custom limits

API Support

Need help with the API? Our developer support team is here to assist you.

api@iterabiz.com