WAN 2.7 - Text to Video

Text-to-video with improved quality, multi-shot generation, up to 1080p, 2-15s duration, and optional audio.

Try WAN 2.7 - Text to Video in the Workbench

Run this model interactively, tune parameters, and compare outputs.

Model ID: wan-v2-7-text-to-video

WAN 2.7 text-to-video generates video from a text prompt with enhanced motion smoothness, superior scene fidelity, and greater visual coherence over previous versions. It supports 720p and 1080p output, durations from 2-15 seconds, multiple aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4), multi-shot video generation controlled via natural language in the prompt, and optional driving audio.

Example request

Use the Workbench as a request builder: configure parameters for this model in the UI, then open the API tab to copy the exact cURL or Python call.

Sync

This blocks until the video is ready (typically 5-15 minutes). Prefer Async or Async with SSE for anything beyond quick experimentation.

See the video generation reference for more details.

Minimal

cURL

curl -X POST https://hub.oxen.ai/api/ai/videos/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "wan-v2-7-text-to-video",
  "prompt": "A kitten running in a meadow, cinematic lighting, smooth camera movement."
}'

All parameters

cURL

curl -X POST https://hub.oxen.ai/api/ai/videos/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "wan-v2-7-text-to-video",
  "prompt": "A kitten running in a meadow, cinematic lighting, smooth camera movement.",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}'

Async

See the async queue reference for more details.

Minimal

cURL

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "wan-v2-7-text-to-video",
  "prompt": "A kitten running in a meadow, cinematic lighting, smooth camera movement."
}' | jq -r '.generations[0].generation_id')

# Poll the single generation until it 404s (terminal state).
while curl -s -o /dev/null -w "%{http_code}" \
    -H "Authorization: Bearer $OXEN_API_KEY" \
    "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | grep -q "^200$"; do
  sleep 5
done
echo "Done. See the 'Async with SSE' tab to receive the result URL."

All parameters

cURL

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "wan-v2-7-text-to-video",
  "prompt": "A kitten running in a meadow, cinematic lighting, smooth camera movement.",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}' | jq -r '.generations[0].generation_id')

# Poll the single generation until it 404s (terminal state).
while curl -s -o /dev/null -w "%{http_code}" \
    -H "Authorization: Bearer $OXEN_API_KEY" \
    "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | grep -q "^200$"; do
  sleep 5
done
echo "Done. See the 'Async with SSE' tab to receive the result URL."

Async with SSE

See the async queue reference for more details.

Minimal

cURL

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "wan-v2-7-text-to-video",
  "prompt": "A kitten running in a meadow, cinematic lighting, smooth camera movement."
}' | jq -r '.generations[0].generation_id')

# Stream the SSE channel, grab the data line that follows a
# media_generation_completed event for our id, and pretty-print it.
curl -sN -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/events \
  | awk -v id="$GEN_ID" '
    /^event: media_generation_completed$/ { expect=1; next }
    /^data: / && expect {
      payload = substr($0, 7)
      if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit }
      expect = 0
    }
  ' | jq .

All parameters

cURL

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "wan-v2-7-text-to-video",
  "prompt": "A kitten running in a meadow, cinematic lighting, smooth camera movement.",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}' | jq -r '.generations[0].generation_id')

# Stream the SSE channel, grab the data line that follows a
# media_generation_completed event for our id, and pretty-print it.
curl -sN -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/events \
  | awk -v id="$GEN_ID" '
    /^event: media_generation_completed$/ { expect=1; next }
    /^data: / && expect {
      payload = substr($0, 7)
      if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit }
      expect = 0
    }
  ' | jq .

Fetch model details

The models endpoint returns the full model object, including its json_request_schema.

curl -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/ai/models/wan-v2-7-text-to-video

Request parameters

Required parameters

Field	Type	Default	Description
prompt	string	"A kitten running in a meadow, cinematic lighting, smooth camera movement."	Text prompt describing the desired video. Max 5000 characters.

Optional parameters

Field	Type	Default	Description
aspect_ratio	string	"16:9"	Aspect ratio of the generated video. One of: 16:9, 9:16, 1:1, 4:3, 3:4.
resolution	string	"1080p"	Output video resolution tier. One of: 720p, 1080p.
duration	integer	5	Output video duration in seconds (2-15). Range: 2 – 15.
negative_prompt	string	—	Content to avoid in the video. Max 500 characters.
audio_url	string	—	URL of driving audio. Supports WAV and MP3. Duration: 3-30s. Max 15 MB. If not provided, the model auto-generates matching background music. Format: uri.
seed	integer	—	Random seed for reproducibility (0-2147483647).