Skip to main content
POST
/
generate
/
videos
Generate videos
curl --request POST \
  --url https://api.horizon.new/v1/generate/videos \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "<string>",
  "durationSeconds": 10,
  "resolution": "720p",
  "referenceFrames": [
    "<string>"
  ],
  "soundtrack": {},
  "webhookUrl": "<string>"
}'
{
  "jobId": "job_01hx9q9",
  "status": "queued",
  "statusUrl": "<string>",
  "result": {},
  "etaSeconds": 123,
  "jobType": "extract/pdf"
}
Synthesize short clips with motion, lighting, and camera control derived from a textual storyboard. Videos render in H.264 MP4 format and include automatically generated preview GIFs.

​
Request body

  • prompt — Required creative direction or storyboard.
  • durationSeconds — Required integer between 1 and 20.
  • resolution — Optional preset (720p, 1080p, or square); defaults to 720p.
  • referenceFrames — Optional array of image URLs to guide composition.
  • soundtrack — Optional object describing background audio (e.g., { "preset": "ambient" }).
  • webhookUrl — Optional HTTPS URL Horizon should call when the video job finishes.

​
Sample request

curl https://api.horizon.new/v1/generate/videos \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Camera slowly orbits a floating botanical garden in low gravity.",
    "durationSeconds": 8,
    "resolution": "1080p",
    "referenceFrames": [
      "https://cdn.example.com/lookbook/botanical-1.png"
    ]
  }'

​
Response

Video jobs always run asynchronously. The API returns 202 Accepted with a jobId, statusUrl, and estimated completion etaSeconds. Once finished, the job record includes the MP4 download link, thumbnail URLs, and a storyboard track you can feed into editing tools.

​
Considerations

  • Keep durationSeconds under 10 for fastest results; longer clips may take several minutes.
  • Provide referenceFrames when you need continuity across a series of shots.
  • Use GET /jobs/{jobId} (identical to statusUrl) to poll status or fetch the final video bundle afterward.

​
x402 flow

Video rendering requires an x402 payment. Unfunded calls return 402 Payment Required with a PaymentRequiredResponse payload: 
HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "x402Version": 1,
  "accepts": [
    {
      "scheme": "exact",
      "network": "base-sepolia",
      "maxAmountRequired": "500000",               // $0.50 in 6‑decimal USDC
      "resource": "POST /generate/videos",
      "description": "Horizon video generation",
      "mimeType": "application/json",
      "payTo": "0xYourReceivingWallet",
      "maxTimeoutSeconds": 300,
      "asset": "0xYourUSDCContract",
      "extra": {
        "name": "USDC",
        "version": "1"
      }
    }
  ],
  "error": null
}
Handle the challenge as prescribed in the Coinbase spec:
  1. Send the accepts entry to your facilitator (see Client & server responsibilities) and call /verify + /settle.
  2. Replay the request with the facilitator-issued Base64 payload in X-PAYMENT: 
    curl https://api.horizon.new/v1/generate/videos \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: eyJ4NDAyVmVyc2lvbiI6MSwic2NoZW1lIjoiZXhhY3QiLC4uLn0=" \
  -d '{ ...original body... }'
  3. Horizon validates the header, resumes rendering, and, on success, includes settlement data under X-PAYMENT-RESPONSE.
First-time integrations should complete the Quickstart for sellers to stand up mainnet wallets and facilitator credentials.

Body

application/json
​
prompt
string
required
​
durationSeconds
integer
required
Required range: 1 <= x <= 20
​
resolution
enum<string>
default:720p
Available options:
720p,
1080p,
square
​
referenceFrames
string<uri>[]
​
soundtrack
object
​
webhookUrl
string<uri>

Webhook to call when the video job completes.

Response

Video generation job accepted

​
jobId
string
required
Example:

"job_01hx9q9"

​
status
enum<string>
required
Available options:
queued,
processing,
completed,
failed
​
statusUrl
string<uri>
required

Canonical link to GET /jobs/{jobId} for this job.

​
jobType
string
required
Example:

"extract/pdf"

​
result
object | null

Present when the job completes synchronously.

​
etaSeconds
integer | null

Estimated seconds until completion.