xW 2.7 S

REQUIRED. Email of YOUR real end-user inside your product — the person who actually triggered this video. We use it to attribute every request and give you a chain of responsibility: you can list, audit, and delete that user's videos. Do NOT pass a fake address, a shared placeholder, or someone else's email — that's a policy violation.

Example: "alice@your-product.com"

Public model alias. Required — pass the alias of the video model you want to use (e.g. xW2.7S).

Example: "xW2.7S"

English text prompt describing the motion, action, and mood you want from the input image. Up to 8000 characters.

Example: "A girl dancing gracefully in a flower field, camera slowly pushing in"

Input image to animate (publicly fetchable HTTPS URL). Supported formats JPEG, PNG (no transparency), BMP, WEBP. Width and height 240–8000 px, aspect ratio between 1:8 and 8:1, max 20 MB.

Example: "https://example.com/input-image.png"

Elements to exclude from the video.

Example: "blurry, distorted face, extra limbs"

Optional audio track (HTTPS URL) to drive the video. Supported formats WAV, MP3. Duration 2–30 seconds, max 15 MB.

Example: "https://example.com/speech.mp3"

Output video resolution. "720p" or "1080p".

Example: "1080p"

Video duration in seconds (2–15). Billed per second of output.

Example: 10

When enabled, the system expands and optimizes your prompt before generation. Free. On by default for this model, and worth knowing when you pass a `seed`: the rewrite differs between runs, so the same seed does not guarantee the same video unless you also send `prompt_extend: false`.

Determinism seed (0–2147483647). Pass null or omit for an auto-generated seed. Note that `prompt_extend` is ON by default for this model and rewrites your prompt differently on each run, so a fixed seed only holds the result steady when you also send `prompt_extend: false`.

Example: 42

Optional public HTTPS URL we will POST the final record to once the video is succeeded or failed. The body is identical to what GET /v1/videos/:requestId returns. Each delivery is HMAC-signed (`X-XMode-Signature: v1=<hex>`) and timestamped (`X-XMode-Timestamp`); reject anything older than 5 minutes. Private/loopback IPs are refused (SSRF guard).

Example: "https://your-app.example.com/hooks/xmode"

Unique id of the video request. Use it with GET /v1/videos/:requestId to poll.

Public alias of the model that will produce the video.

Lifecycle marker. POST always returns `queued`. GET returns the current state. `expired` means the request succeeded more than 23 hours ago and signed URLs no longer work — re-run if you need the video again.

Present on `queued` responses only. Absolute URL to GET for status. Recommended polling cadence: every 5 seconds until terminal.

Present only when status=`succeeded`. Each item has `id`, `expiresAt`, optional `duration`/`resolution`, and EITHER `url` (signed, valid 23 h) OR `error: { code: "storage_failed" }` if our storage layer dropped that video. If every video of the request is dropped there is nothing to deliver, so the request comes back `failed` and refunded instead. The URL is re-signed on every read, so re-reading this record replaces a link that went stale on your side — but that never moves `expiresAt`, which is fixed when the generation completed. Once it passes, the record returns status `expired` with no URL and the bytes are gone. Download inside the window or re-generate.

Present only when status=`failed`. `{ code, message }`. Same code values as the top-level error format (validation_error, content_policy, provider_error, provider_timeout, internal_error).

Present only when status=`succeeded`. `{ xTokens: number }`. Debited at request time; refunded automatically on `failed`.

Present on terminal statuses (`succeeded`, `failed`, `expired`).

Echoed back so you can confirm the grouping. Always lowercase.

When the request was accepted (POST time).