Free AI Video API & MCP

Get started

1. Sign in to Free AI Video and open Account.
2. Under AI agent access, create an API key and save it when it appears. You can revoke it from the same screen.
3. Send the key with each request in the Authorization: Bearer YOUR_API_KEY header.

Keep your key private. Do not embed it in browser code or commit it to a public repository. Keys are shown only once.

The API uses paid account credits; website free trials are not available through this interface. Each account can make 3,000 agent API requests per UTC day across all its keys. Some MCP calls use two requests. The limit returns HTTP 429.

HTTP API

Base URL: https://www.freeaivideo.app

Reference images

To upload an image, send raw bytes to POST /api/agent/uploads with a Content-Length and a content type of image/png, image/jpeg, or image/webp. The maximum is 10 MB and each dimension must be at least 160 pixels. The response contains a site path and URL.

Use the returned site path in a job’s references array. External image URLs are not accepted, and reference requirements vary by model.

Create a job

Choose a model and supported settings from GET /api/agent/models. Send a model ID and a nonempty prompt; settings and references are optional.

{
  "modelId": "seedance-2-5-v2",
  "prompt": "A paper boat sailing across a moonlit lake",
  "parameters": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

Send this body to POST /api/agent/jobs with Content-Type: application/json and an Idempotency-Key. The response contains a job with an ID. Poll GET /api/agent/jobs/{jobId} for status and output URLs. Anyone with an output URL can access it, so treat the URL as private.

Retrying safely

Use a fresh idempotency key for each intended generation. It must contain 1–128 ASCII letters, digits, ., _, ~, or -. If a response is lost, retry with the same key and the same JSON values. Object property order and whitespace do not matter; changed values with the same key are rejected. A new key may create and charge for another job.

In the rare case that service is interrupted after a job and its credit reservation are created but before dispatch, a retry can return that job as queued. It will be handled by the timeout process. Do not retry with a new key; contact support@freeaivideo.app with the job ID.

Errors include an error object. For example, insufficient credits return HTTP 402.

Example request

Store the key in an environment variable before running this command:

curl https://www.freeaivideo.app/api/agent/jobs \
  -H "Authorization: Bearer $FREEAIVIDEO_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: example-video-001' \
  --data '{"modelId":"seedance-2-5-v2","prompt":"A paper boat sailing across a moonlit lake"}'

Connect an AI agent with MCP

Use an MCP client that supports Streamable HTTP and a static authorization header.

URL

https://www.freeaivideo.app/api/mcp

Header

Authorization: Bearer YOUR_API_KEY

Protocol version

2025-06-18

The stateless server returns JSON responses and provides list_video_models, get_credit_balance, create_video, and get_video_job.

create_video spends credits and accepts idempotencyKey, modelId, prompt, and optional parameters and references. Reuse the same key and arguments when retrying. Upload any reference image with the HTTP API first.

The endpoint does not support server-initiated SSE, MCP sessions, OAuth discovery or login, the older HTTP+SSE transport, or an MCP upload tool. Your client must send the Bearer header on every request. Browser-origin requests are accepted only from the site’s own origin.