API REFERENCE

Video

Generiere Video-Clips mit einem Async-Task-Modell — Prompt einreichen, Status pollen, Ergebnis abholen.

Video-Generierung läuft im Hintergrund — kein Streaming-Render. Der Ablauf ist immer: Task erstellen → Status pollen → MP4 herunterladen. Tasks laufen nach 24 Stunden ab.

1. Task erstellen

Übermittelt den Job und gibt eine Task-ID zurück. Die Kosten werden vorab basierend auf duration × Pro-Sekunden-Preis des gewählten Modells abgebucht.

POSThttps://api.airforce/v1/video/generations

Video-Modelle

…· live

Parameter	Type	Required	Description
model	string	Required	Video model ID. Use /v1/models and filter by output_modalities.includes("video").
prompt	string	Required	Scene description.
mode	string	Optional	"text" (default), "image" (animate a first-frame image), "reference" (style transfer from one or more frames).
duration_seconds	integer	Optional	Clip length. Range depends on the model — typically 5, 8 or 10 s. Defaults to the model's minimum.
aspect_ratio	string	Optional	"16:9", "9:16", "1:1", "4:3" — must be in the model's supported list.
quality	string	Optional	"480p", "720p", "1080p" — must be in the model's supported list.
input_images	array	Optional	[{ url? } \| { b64_json? }] — required for "image" and "reference" modes.
seed	integer	Optional	Reproducibility seed where supported.
sound	boolean	Optional	Enable native audio track on models that produce sound (e.g. wan).

Beispiele

Text-zu-Video

curl https://api.airforce/v1/video/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-2.6",
    "prompt": "A red fox darting across snowy hills at dawn",
    "duration_seconds": 8,
    "aspect_ratio": "16:9",
    "quality": "720p",
    "sound": true
  }'

Bild-zu-Video (erstes Frame)

curl https://api.airforce/v1/video/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-1",
    "mode": "image",
    "prompt": "Camera pulls back as the dragon takes off",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "input_images": [{"url": "https://example.com/dragon.jpg"}]
  }'

Response

Parameter	Type	Required	Description
task_id	string	Optional	Persistent task identifier. Use it on every follow-up endpoint.
status	string	Optional	"queued" right after creation.
model	string	Optional	Echo of requested model.
created	integer	Optional	Unix timestamp.
expires_at	integer	Optional	Unix timestamp after which the result is purged (typically created + 86400).
cost_cents	number	Optional	Up-front cost debited from your balance. Refunded if the task ultimately fails.

{
  "task_id": "vid_01HXY1234ABCD",
  "status": "queued",
  "model": "wan-2.6",
  "created": 1715000000,
  "expires_at": 1715086400,
  "cost_cents": 320
}

2. Status pollen

Pollen alle 5–15 Sekunden. Tasks brauchen typischerweise 30 s – 4 min je nach Länge und Modell. Derselbe Endpoint liefert die Result-URL sobald der Status auf "completed" wechselt.

GEThttps://api.airforce/v1/video/tasks/:task_id

Parameter	Type	Required	Description
status	string	Optional	"queued" \| "running" \| "completed" \| "failed" \| "expired".
progress	integer	Optional	0–100 while running. Absent for queued tasks.
result_url	string	Optional	MP4 download URL once status is "completed". Pre-signed; valid until expires_at.
thumbnail_url	string	Optional	Optional poster frame.
error	object	Optional	Set when status is "failed". { type, message }.
cost_cents	number	Optional	Final cost. Equals the create-time cost on success.

{
  "task_id": "vid_01HXY1234ABCD",
  "status": "completed",
  "progress": 100,
  "result_url": "https://cdn.api.airforce/video/vid_01HXY1234ABCD.mp4",
  "thumbnail_url": "https://cdn.api.airforce/video/vid_01HXY1234ABCD.jpg",
  "model": "wan-2.6",
  "duration_seconds": 8,
  "expires_at": 1715086400,
  "cost_cents": 320
}

2b. Fortschritt streamen (optional)

Spar dir die Polling-Schleife mit einem Server-Sent Events Stream. Sendet ein Event pro Fortschrittsänderung und schließt sich sobald der Task in einem Endzustand ist. Gleiches Payload-Format wie der GET-Endpoint.

GEThttps://api.airforce/v1/video/tasks/:task_id/stream

event: progress
data: {"task_id":"vid_01HXY...","status":"running","progress":12}

event: progress
data: {"task_id":"vid_01HXY...","status":"running","progress":58}

event: completed
data: {"task_id":"vid_01HXY...","status":"completed","progress":100,"result_url":"https://cdn.api.airforce/video/vid_01HXY....mp4"}

3. Listen und löschen

GEThttps://api.airforce/v1/video/tasks

Gibt deine letzten Tasks zurück (neueste zuerst). Praktisch fürs Dashboard um eine Verlaufs-Ansicht zu rendern.

Parameter	Type	Required	Description
limit	integer	Optional	Max items returned. Default 50, max 200. Pass as a query string.
status	string	Optional	Filter to one status, e.g. ?status=running.

curl "https://api.airforce/v1/video/tasks?limit=20&status=completed" \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY"

DELETEhttps://api.airforce/v1/video/tasks/:task_id

Entfernt den Task aus deinem Verlauf. Die MP4 wird auch aus dem CDN-Storage gelöscht. Keine Erstattung — die Kosten wurden bereits abgebucht.

Kosten & Constraints

Jedes Video-Modell exponiert Capability-Metadaten die du aus /v1/models:

Parameter	Type	Required	Description
video_caps.aspect_ratios	array	Optional	Allowed aspect_ratio values.
video_caps.qualities	array	Optional	Allowed quality values.
video_caps.min_duration_s / max_duration_s	integer	Optional	Allowed range for duration_seconds.
video_caps.modes	array	Optional	Subset of ["text", "image", "reference"] supported.
video_caps.price_per_second_cents	integer	Optional	Cost = duration_seconds × this value.

Cost is debited at task creation. Failed tasks (status "failed" or "expired") refund the cost.
Max 4 concurrent video tasks per API key.
Result URLs are pre-signed and stop working at expires_at. Download or copy the MP4 to your own storage if you need it longer.

End-to-End Script

async function generateVideo(prompt) {
  const create = await fetch('https://api.airforce/v1/video/generations', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'wan-2.6',
      prompt,
      duration_seconds: 8,
      aspect_ratio: '16:9',
      quality: '720p',
    }),
  }).then(r => r.json());

  const { task_id } = create;

  // Poll until done.
  while (true) {
    await new Promise(r => setTimeout(r, 8_000));
    const task = await fetch(
      `https://api.airforce/v1/video/tasks/${task_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } },
    ).then(r => r.json());

    if (task.status === 'completed') return task.result_url;
    if (task.status === 'failed' || task.status === 'expired') {
      throw new Error(task.error?.message ?? task.status);
    }
  }
}