REST API

Build with ManifoldGen

Generate native video with audio and production-ready images through one small JSON API. Pay only for successful generations.

Quickstart

1. Create a key

2. Add credits

Credits are pay-as-you-go and never expire.

3. Generate

Send a prompt, then poll the returned job URL.

Send your key as Authorization: Bearer …. Keep it on your server; never ship it in public browser code.

Generate video

Creates an asynchronous video job. Audio is enabled by default.

curl https://manifoldgen.com/api/service \
  -X POST \
  -H "Authorization: Bearer $MANIFOLDGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "h3_video",
    "prompt": "A glass greenhouse at night, rain on the roof",
    "aspect_ratio": "16:9",
    "size": "native",
    "duration": 5,
    "num_steps": 20,
    "include_audio": true,
    "output_format": "webm-av1"
  }'

202 Accepted

{
  "result": {
    "job_id": "8a17…",
    "status": "queued",
    "status_url": "/api/video-jobs/8a17…"
  },
  "estimated_credits": 101,
  "estimated_cost_usd": 1.01
}

sizepreview | balanced | native | audioDefault: balanced

duration4–60 seconds (audio: up to 45)Default: 5

aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 21:9Default: 16:9

num_steps8–30; more steps increase time and priceDefault: 20

include_audioGenerate native audio when availableDefault: true

output_formatwebm-av1 | mp4-h264Default: webm-av1

Poll a job

Poll every 2–5 seconds until status is completed. Completed responses include the durable video URL, actual cost, and credits used.

curl https://manifoldgen.com/api/video-jobs/8a17… \
  -H "Authorization: Bearer $MANIFOLDGEN_API_KEY"

Store the job ID. Jobs survive client disconnects and can be recovered later.

Generate images

Image requests return synchronously and start at 4 credits.

curl https://manifoldgen.com/api/service \
  -X POST \
  -H "Authorization: Bearer $MANIFOLDGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "zimage",
    "prompt": "Editorial portrait, hard side light",
    "width": 1024,
    "height": 1024,
    "num_steps": 12
  }'

Clear, usage-based pricing

The create response includes an estimate before the job runs. Video is billed from actual generation time, resolution, duration, and steps; the completed job contains the final dollar and credit amounts. One credit is approximately $0.01. Fetch current estimates from /api/pricing.

Image

from 4 credits

5s native video

estimate returned by API

Errors

400Invalid request or unsupported option

401Missing or invalid API key

402Not enough credits to release the result

404Job or resource not found

429 / 503Capacity unavailable; retry with backoff

JSON responses use a stable error message.