Skip to main content

​
Overview

Developer guide for two core endpoints:
  • Trigger an AI talking video job: POST /jobs/v2
  • Generate a signed download URL: GET /storage/generate-signed-path
The OpenAPI spec lives in openapi.json and powers the API reference in this docs site.

​
Base URL

  • Live: https://api.techforgeinnovate.com

​
Authentication

All endpoints require an API key sent via header: 
x-api-key: YOUR_API_KEY
Store keys securely and rotate if compromised. Avoid embedding in client-side code.
Get your API key at https://app.techforgeinnovate.com/api-access

​
Endpoints

​
POST /jobs/v2 — Trigger AI talking video

Creates an asynchronous rendering job for an AI talking video. You receive a job ID you can track with your job service. Request body (example) 
{
	"image_url": "https://cdn.example.com/image.png",
	"audio_url": "https://cdn.example.com/audio.mp3",
	"is_clone_required": false,
	"language": "en",
	"version": 6,
	"job_type": "ai_talking_video",
	"project_id": "468ea7a0-66e1-4357-a760-236e54167f3e",
	"output_size": 400,
	"crop": true,
	"dynamic_scale": 1,
	"iteration_count": 10,
	"expand_ratio": 0.5,
	"values": []
}
Responses
  • 202 Accepted with { "jobId": "<uuid>", "status": "queued" }
  • 400 Bad Request for invalid payloads
  • 401 Unauthorized for missing/invalid API key
Notes
  • The job is asynchronous; poll your jobs service or webhook for completion.
  • Use signed URLs to retrieve outputs when ready.

​
GET /storage/generate-signed-path — Signed URL

Returns a short-lived signed URL for a storage object. Query parameters
  • path (string, required): storage key, e.g. ai-talking-videos/{projectId}/outputs/{file}.mp4
Responses
  • 200 OK with { "signedUrl": "https://...", "expiresAt": "2024-12-01T12:00:00Z" }
  • 401 Unauthorized for missing/invalid API key
  • 404 Not Found if the storage key does not exist

​
Error handling

  • 400 — validation errors; check required fields and formats.
  • 401 — missing or invalid x-api-key.
  • 404 — resource not found (e.g., storage path).
  • 5xx — retry with backoff; contact support if persistent.

​
Rate limits

If you receive 429 Too Many Requests, reduce concurrency and implement exponential backoff. Contact support to raise limits.

​
Change log

  • v1.0.0 — Initial OpenAPI for job creation and signed URLs.