/api/v1/videos/generations

# 1. Start the job
curl https://railwail.com/api/v1/videos/generations \
  -H "Authorization: Bearer $RAILWAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-1",
    "prompt": "A slow drone shot over a misty pine forest at sunrise"
  }'

# 2. Poll until status is completed (replace JOB_ID)
curl https://railwail.com/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAILWAIL_API_KEY"

# pip install requests
import os, time, requests

BASE = "https://railwail.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['RAILWAIL_API_KEY']}"}

job = requests.post(
    f"{BASE}/videos/generations",
    headers=HEADERS,
    json={"model": "kling-v2-1", "prompt": "A slow drone shot over a misty pine forest at sunrise"},
    timeout=60,
)
job.raise_for_status()
job_id = job.json()["job_id"]

deadline = time.time() + 15 * 60  # give up after 15 minutes
while time.time() < deadline:
    status = requests.get(f"{BASE}/jobs/{job_id}", headers=HEADERS, timeout=60).json()
    if status["status"] == "completed":
        print(status["output_url"])
        break
    if status["status"] in ("failed", "cancelled"):
        raise RuntimeError(status.get("error") or status["status"])
    time.sleep(8)

// Node 18+ (global fetch). ESM: save as video.mjs
const BASE = "https://railwail.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.RAILWAIL_API_KEY}`,
  "Content-Type": "application/json",
};

const res = await fetch(`${BASE}/videos/generations`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    model: "kling-v2-1",
    prompt: "A slow drone shot over a misty pine forest at sunrise",
  }),
});
if (!res.ok) throw new Error((await res.json()).error?.message);
const { job_id } = await res.json();

const deadline = Date.now() + 15 * 60_000; // give up after 15 minutes
while (Date.now() < deadline) {
  const job = await (await fetch(`${BASE}/jobs/${job_id}`, { headers })).json();
  if (job.status === "completed") {
    console.log(job.output_url);
    break;
  }
  if (job.status === "failed" || job.status === "cancelled") throw new Error(job.error ?? job.status);
  await new Promise((r) => setTimeout(r, 8000));
}

{
  "job_id": "<uuid>",
  "id": "<uuid>",
  "object": "video.generation",
  "status": "queued",
  "model": "kling-v2-1",
  "provider_job_id": "<provider id>",
  "estimated_duration_seconds": <number>,
  "created_at": <unix seconds>,
  "cost": { "credits": <number>, "currency": "credits" }
}