Scene Projects API

{
  "id": 42,
  "description": "A tech startup journey",
  "ideas": "From garage to IPO",
  "status": "completed",
  "progress": 100,
  "person_id": 1,
  "user_id": 1,
  "final_video_url": "https://storage.twin.actor/videos/project_42_final.mp4",
  "final_video_url_upscaled": null,
  "total_duration_seconds": 50,
  "use_avatar_first_scene": false,
  "use_avatar_last_scene": false,
  "scenes": [
    {
      "id": 1,
      "scene_number": 1,
      "description": "Founder coding in garage",
      "image_prompt": "Photorealistic, developer at desk...",
      "motion_prompt": "Slow push-in, screen glow...",
      "narration_text": "Every great company starts...",
      "image_url": "https://storage.twin.actor/scenes/1/image.jpg",
      "video_url": "https://storage.twin.actor/scenes/1/video.mp4",
      "status": "completed"
    }
  ],
  "created_at": "2024-03-20T10:00:00Z",
  "updated_at": "2024-03-20T10:15:00Z"
}

{
  "id": 42,
  "status": "proposed",
  "story_idea": "A startup founder's journey...",
  "num_scenes": 5,
  "person_id": 1,
  "scenes": [
    {
      "scene_number": 1,
      "description": "Late night in a cramped garage, a determined founder writes the first lines of code",
      "image_prompt": "Photorealistic, young entrepreneur coding at a makeshift desk in a garage, multiple monitors glowing blue, scattered energy drink cans, dim lighting, cinematic, 8K",
      "motion_prompt": "Slow push-in towards the screen, flickering monitor light, subtle keyboard typing motion",
      "narration_text": "Every billion-dollar company starts with a single line of code. This is where the dream began.",
      "status": "pending"
    },
    {
      "scene_number": 2,
      "description": "The first team meeting in a small apartment, whiteboard covered in ideas",
      "image_prompt": "Photorealistic, small team of developers in a living room, whiteboard with startup diagrams, excited expressions, laptops everywhere, natural lighting, cinematic",
      "motion_prompt": "Pan across the whiteboard, zoom into faces showing determination",
      "narration_text": "Three developers, one apartment, and a vision that would change everything.",
      "status": "pending"
    }
    // ... more scenes
  ],
  "created_at": "2024-03-20T10:00:00Z"
}

curl "https://api.twin.actor/api/v1/scene-projects?status_filter=completed" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl https://api.twin.actor/api/v1/scene-projects/42 \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X PUT https://api.twin.actor/api/v1/scene-projects/42/scenes/1 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "narration_text": "Updated narration for scene 1...",
    "image_prompt": "Enhanced prompt with more detail..."
  }'

{
  "id": 42,
  "status": "generating",
  "progress": 0,
  "message": "Video generation started. Use GET /scene-projects/42/status to track progress."
}

curl https://api.twin.actor/api/v1/scene-projects/42/status \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "id": 42,
  "status": "generating",
  "progress": 65,
  "current_step": "generating_scene_videos",
  "scenes": [
    {
      "scene_number": 1,
      "image_status": "completed",
      "video_status": "completed",
      "image_url": "https://storage.twin.actor/scenes/1/image.jpg",
      "video_url": "https://storage.twin.actor/scenes/1/video.mp4"
    },
    {
      "scene_number": 2,
      "image_status": "completed",
      "video_status": "completed"
    },
    {
      "scene_number": 3,
      "image_status": "completed",
      "video_status": "generating"
    },
    {
      "scene_number": 4,
      "image_status": "completed",
      "video_status": "pending"
    },
    {
      "scene_number": 5,
      "image_status": "completed",
      "video_status": "pending"
    }
  ]
}

{
  "id": 42,
  "status": "completed",
  "progress": 100,
  "final_video_url": "https://storage.twin.actor/videos/project_42_final.mp4",
  "total_duration_seconds": 50,
  "credits_used": 500
}

curl -X POST https://api.twin.actor/api/v1/scene-projects/42/scenes/3/regenerate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "regenerate_image": true,
    "regenerate_video": true,
    "updated_image_prompt": "More dramatic lighting, intense expression..."
  }'

curl -X POST https://api.twin.actor/api/v1/scene-projects/42/upscale \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "id": 42,
  "status": "upscaling",
  "message": "Upscaling started. This may take 5-10 minutes."
}

123456789101112131415161718192021222324252627282930313233343536373839404142434445"text-violet-400">import requests
"text-violet-400">import time

API_BASE = "https://api.twin.actor/api/v1"
headers = {"Authorization": f"Bearer {token}"}

# Create project
project = requests.post(
    f"{API_BASE}/stories/create",
    headers=headers,
    json={
        "person_id": 1,
        "story_idea": "A day ">in the life of a startup founder",
        "num_scenes": 5
    }
).json()

project_id = project["id"]
print(f"Created project {project_id}")

# Approve
requests.post(
    f"{API_BASE}/scene-projects/{project_id}/approve",
    headers=headers,
    json={"confirm_credits": "text-violet-400">True}
)
print("Generation started")

# Poll "text-violet-400">for completion
"text-violet-400">while "text-violet-400">True:
    status = requests.get(
        f"{API_BASE}/scene-projects/{project_id}/status",
        headers=headers
    ).json()

    print(f"Progress: {status['progress']}%")

    "text-violet-400">if status["status"] == "completed":
        print(f"\nDone! Video: {status['final_video_url']}")
        break
    "text-violet-400">elif status["status"] == "failed":
        print(f"\nFailed: {status.get('error')}")
        break

    time.sleep(30)  # Poll every 30 seconds