Developer API

Automate cinematic generation through API

Trigger renders, track jobs, and route outputs into your product or production pipeline with secure endpoints.

JavaScript

API Example

import fetch from 'node-fetch';

const res = await fetch('https://api.cineforgeai.studio/generate/video', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    prompt: 'Wide shot of futuristic city at dawn',
    mode: 'text-to-video',
    durationSec: 8,
    resolution: '1080p'
  })
});

const data = await res.json();
console.log(data.jobId);

Python

API Example

import requests

payload = {
  "prompt": "Portrait shot, neon cyberpunk alley, cinematic rain",
  "mode": "image-to-video",
  "durationSec": 6,
  "resolution": "4k"
}

response = requests.post(
  "https://api.cineforgeai.studio/generate/video",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json=payload,
  timeout=30,
)

print(response.json())

Endpoints

Core requests

Start jobs and fetch status with simple REST semantics.

POST /generate/video

Create a new generation job and receive a queued job ID.

GET /job/:id

Retrieve live status, progress metadata, and output links.

Webhooks

Event-driven delivery

Receive signed callbacks so your app updates when renders complete or fail.

`job.queued` after request validation and queue acceptance.
`job.completed` with render URLs, duration, and metadata.
`job.failed` with machine-readable error payloads.

Build with CineForge API

Get technical onboarding, usage limits, and sandbox credentials for your integration.

Request API Access