OdinxD MCP Server & REST API v1 Reference

# 1. Check your render quota and AI credits
curl -s https://odinxd.com/api/v1/me \
  -H "Authorization: Bearer odx_live_YOUR_API_KEY"

# 2. (Optional) Upload a local video and room photos from your machine or server
curl -s -X POST https://odinxd.com/api/v1/upload \
  -H "Authorization: Bearer odx_live_YOUR_API_KEY" \
  -F "video=@./agent_aroll.mp4" \
  -F "avatarImage=@./agent_face.jpg" \
  -F "inmoPhotos=@./kitchen.jpg" \
  -F "inmoPhotos=@./terrace.jpg"

# 3. Enqueue a render (Faceless Ad, Hybrid Mode, ViralBeat, Motion Stock, etc.)
curl -s -X POST https://odinxd.com/api/v1/jobs \
  -H "Authorization: Bearer odx_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "create_faceless_ad",
    "arguments": {
      "product_name": "Aurum Skincare Serum",
      "description": "Pure vitamin C antioxidant serum for radiant skin in 14 days.",
      "faceless_mode": "commercial_narrated",
      "target_duration": 30,
      "lang": "en",
      "voice_id": "emma_glow_en",
      "bg_music": "skincare_glow_110"
    }
  }'

# 4. Poll progress and retrieve the direct HD MP4 URL
curl -s https://odinxd.com/api/v1/jobs/job_8f92a1c4b3e2 \
  -H "Authorization: Bearer odx_live_YOUR_API_KEY"

import time
import requests

API_KEY = "odx_live_YOUR_API_KEY"
BASE_URL = "https://odinxd.com/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Upload local media (optional if you already have public https:// URLs)
with open("my_clean_aroll.mp4", "rb") as vf:
    up = requests.post(f"{BASE_URL}/upload", headers=HEADERS, files={"video": vf}).json()
uploaded_video_path = up["files"][0]["path"]

# 2. Enqueue Hybrid Mode Reel
job_resp = requests.post(
    f"{BASE_URL}/jobs",
    headers=HEADERS,
    json={
        "tool": "render_hybrid_reel",
        "arguments": {
            "video_url": uploaded_video_path,
            "ai_styles": ["scrapbook_polaroid", "stock_hyperreal"],
            "clips_count": 2,
            "clip_duration": 5,
            "typography": "Montserrat",
        },
    },
).json()

job_id = job_resp["jobId"]
print("Render queued:", job_id)

# 3. Poll until completion and get HD MP4 link
while True:
    st = requests.get(f"{BASE_URL}/jobs/{job_id}", headers=HEADERS).json()
    print(f"[{st['progressPercent']}%] {st['stageMessage']}")
    if st["status"] == "done":
        print("HD MP4 ready:", st["downloadUrl"])
        break
    if st["status"] == "failed":
        raise RuntimeError(st["stageMessage"])
    time.sleep(15)

Take my product photo C:/Brand/serum.png and creator photo C:/Brand/creator.jpg. First fuse them into a single photo holding the serum with generate_ai_image (1 credit), then shoot a 3-take 45-second English UGC ad locking voice 'Aoede' (or 10 distinct 15s hook ads in parallel) and master the final MP4 to my Desktop with assemble_local_timeline and clean captions.

Write and direct Episode 1 (50 seconds) of a corporate thriller vertical microdrama. First generate casting portraits for the 2 leads with generate_ai_image (purpose='character_casting', aesthetic='cinema_35mm'), shoot all 5 scenes via generate_ai_video_batch locking their faces and voices ('Kore' and 'Charon'), and assemble the finished episode locally via assemble_local_timeline.

I have 3 raw takes at C:/Videos/take1.mp4, C:/Videos/take2.mp4, and C:/Videos/take3.mp4 with pauses and a couple of retakes. First use your local tools (FFmpeg / transcription) to cut dead silences, remove repeated lines, and merge them into a single clean C:/Videos/clean_aroll.mp4, then send that file to OdinxD in Hybrid Mode with 3 AI clips ('scrapbook_polaroid', 'stock_hyperreal').

Check my OdinxD quota first. Then create a 30-second English narrated Faceless Ad for "Velvet Coffee Roasters" (freshly roasted specialty coffee delivered in 24h), using voice 'odin_pro_en' and music 'minimal_luxury_122', and give me the HD MP4 link once ready.

Edit C:/Videos/agent_penthouse.mp4 in Hybrid Mode with 3 clips of 5s using 'inmo_avatar_stock' and 'inmo_tour_transition', font 'Playfair Display', my face photo C:/Videos/agent_avatar.jpg, and room photos C:/Videos/living.jpg (sala), C:/Videos/kitchen.jpg (cocina), and C:/Videos/master.jpg (habitacion_principal). Save the finished MP4 to my Desktop.

Edit https://dl.dropboxusercontent.com/s/example/coach_reel.mp4 using render_motion_stock (0 AI credits) with font 'Anton' and share the HD MP4 download URL when done.