The Programmatic Image & Cinema API for Autonomous AI Bots

curl -X POST https://ibcreator.app/api/v1/shoots \
  -H "Authorization: Bearer ibc_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Golden hour editorial portrait in Parisian cafe terrace, wearing cashmere knit",
    "tier": "basic",
    "aspect_ratios": ["1:1", "4:5", "9:16"],
    "variation_count": 4,
    "strategy": "reframe",
    "webhook_url": "https://your-bot-server.com/webhooks/ibcreator"
  }'

curl -X POST https://ibcreator.app/api/v1/videos \
  -H "Authorization: Bearer ibc_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "persona_id": "pers_abc123",
    "preset": "dance",
    "camera_motion": "tracking_steadicam",
    "motion_intensity": "energetic",
    "prompt": "Dynamic TikTok choreography in neon cyberpunk studio, locked facial likeness",
    "aspect_ratio": "9:16",
    "duration_seconds": 8,
    "seamless_loop": true,
    "webhook_url": "https://your-bot-server.com/webhooks/video"
  }'

import os, httpx, time

API_KEY = os.environ.get("IBCREATOR_API_KEY", "ibc_live_...")
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
BASE_URL = "https://ibcreator.app/api/v1"

# 1. Check account credit balance
with httpx.Client(base_url=BASE_URL, headers=HEADERS, timeout=30.0) as client:
    account = client.get("/account").json()
    print(f"Credits Remaining: {account['credits']['total']}")

    # 2. Launch photoshoot
    shoot_payload = {
        "prompt": "Modern streetwear lookbook in Tokyo Shibuya crossing, moody neon reflections",
        "tier": "basic",
        "aspect_ratios": ["4:5", "9:16"],
        "variation_count": 2
    }
    shoot = client.post("/shoots", json=shoot_payload).json()
    shoot_id = shoot["id"]
    print(f"Photoshoot initiated: {shoot_id}")

    # 3. Poll for completed 4K assets
    for _ in range(30):
        status = client.get(f"/shoots/{shoot_id}").json()
        if status["status"] in ("completed", "partial"):
            print("Render complete! Asset URLs:")
            for v in status["variations"]:
                print(f"- {v['title']}: {v['image_url']}")
            break
        time.sleep(3)

{
  "mcpServers": {
    "ibcreator": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch", "https://ibcreator.app/api/v1/mcp"],
      "env": {
        "IBCREATOR_API_KEY": "ibc_live_your_api_key_here"
      }
    }
  }
}