Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Generate videos from text prompts, images, or other videos
import os
import requests
import time
HEADERS = {
"Authorization": f"Bearer {os.environ['OXEN_API_KEY']}",
"Content-Type": "application/json",
}
enqueue = requests.post(
"https://hub.oxen.ai/api/ai/queue",
headers=HEADERS,
json={
"model": "bytedance-seedance-2-5-text-to-video",
"prompt": "A red balloon floating upward through blue sky",
"duration": 5,
},
)
enqueue.raise_for_status()
generation_id = enqueue.json()["generations"][0]["generation_id"]
print(f"Enqueued {generation_id}")
while True:
data = requests.get(
f"https://hub.oxen.ai/api/ai/queue/{generation_id}",
headers=HEADERS,
).json()
print(f" {data['status']}")
if data["status"] in {"succeeded", "failed", "cancelled"}:
break
time.sleep(15)
if data["status"] != "succeeded":
raise SystemExit(f"{data['status']}: {data['error_message']}")
with open("output.mp4", "wb") as f:
f.write(requests.get(data["result_url"]).content)
print("Saved output.mp4")
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
-H "Authorization: Bearer $OXEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance-seedance-2-5-text-to-video",
"prompt": "A red balloon floating upward through blue sky",
"duration": 5
}' | jq -r '.generations[0].generation_id')
while true; do
STATUS=$(curl -s -H "Authorization: Bearer $OXEN_API_KEY" \
"https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq -r '.status')
echo "$STATUS"
case $STATUS in succeeded|failed|cancelled) break;; esac
sleep 15
done
curl -s -H "Authorization: Bearer $OXEN_API_KEY" \
"https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq -r '.result_url' \
| xargs curl -o output.mp4
input_images), videos (input_videos) and audio clips (input_audios). Each model’s
API reference lists the inputs it accepts.
curl -X POST https://hub.oxen.ai/api/ai/queue \
-H "Authorization: Bearer $OXEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance-seedance-2-5-reference-to-video",
"prompt": "The ox from the image walks through a misty forest",
"input_images": ["https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png"],
"duration": 5
}'
GET /api/events before you start the generation. You’ll get an
event when the video is ready. See completion events.