CreativeAI API

# OpenAI-compatible — drop-in DALL-E 3 replacement
curl -X POST https://api.creativeai.run/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A serene Japanese garden at sunset",
    "size": "1024x1024",
    "n": 1,
    "character_references": ["https://example.com/char1.png", "https://example.com/char2.png"],
    "camera_angle": "isometric",
    "style_reference_url": "https://example.com/style.jpg"
  }'

# Generate a transparent PNG — perfect for game sprites, stickers, logos
curl -X POST https://api.creativeai.run/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "Pixel art warrior character, 64x64 sprite, clean edges",
    "size": "1024x1024",
    "background": "transparent",
    "n": 1
  }'

# Advanced Editing: Inpainting, Outpainting, Style Transfer
curl -X POST https://api.creativeai.run/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F model="seedream-v4.5-edit" \
  -F image=@product-shot.png \
  -F mask=@hand-mask.png \
  -F prompt="A natural human hand with five fingers holding the product in an expanded cinematic scene" \
  -F outpaint_direction="all" \
  -F style_reference_url="https://example.com/style.jpg" \
  -F size="1024x1024"

# Video Generation — async with polling
# Step 1: Submit video generation job
curl -X POST https://api.creativeai.run/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "prompt": "A drone shot over a coastal city at golden hour, cinematic",
    "duration": 5,
    "aspect_ratio": "16:9",
    "character_reference_url": "https://example.com/character.png",
    "character_references": ["https://example.com/char1.png", "https://example.com/char2.png"],
    "camera_angle": "isometric",
    "style_reference_url": "https://example.com/style.jpg",
    "webhook_url": "https://your-app.com/webhooks/creativeai/video"
  }'

# Response: { "id": "abc123", "status": "processing", ... }

# Step 2: Poll for completion
curl https://api.creativeai.run/v1/video/generations/abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

# Image-to-Video — animate a still image
curl -X POST https://api.creativeai.run/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "prompt": "Camera slowly zooms in, the character turns and smiles",
    "image_url": "https://example.com/portrait.png",
    "duration": 5,
    "aspect_ratio": "9:16"
  }'

# Batch Video Generation — generate up to 20 videos in one request
curl -X POST https://api.creativeai.run/v1/video/generations/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompts": [
      {"prompt": "Product showcase video, rotating 360 degrees", "image_url": "https://example.com/product1.png"},
      {"prompt": "Social media clip, dynamic transitions"},
      {"prompt": "Aerial drone shot over mountains at sunset"}
    ],
    "model": "auto",
    "aspect_ratio": "16:9",
    "duration": 5,
    "webhook_url": "https://your-app.com/webhooks/creativeai/batch"
  }'

# Response: { "batch_id": "video_batch_abc123", "total_jobs": 3, ... }

# Check batch status
curl https://api.creativeai.run/v1/video/generations/batch/video_batch_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

# Voice Generation (Text-to-Speech) — async with polling
# Step 1: Submit voice generation job (8 credits)
curl -X POST https://api.creativeai.run/api/generate/voice \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Welcome to CreativeAI. Your product video is ready.",
    "voice": "alloy",
    "language": "en",
    "speed": 1.0,
    "webhook_url": "https://your-app.com/webhooks/creativeai/voice"
  }'

# Response: { "id": "voice_abc123", "status": "PENDING", ... }

# Step 2: Poll for completion
curl https://api.creativeai.run/api/generate/status/voice_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

# Commerce workflow: cleanup -> motion -> voice -> final MP4
# 1) Enhance the source product image for marketplace-safe lighting/background
curl -X POST https://api.creativeai.run/v1/images/edits   -H "Authorization: Bearer YOUR_API_KEY"   -F model="seedream-v4.5-edit"   -F image=@product.jpg   -F prompt="Clean up this product photo, sharpen details, improve lighting, and place the item on a clean white studio background with a soft natural shadow"   -F size="1024x1024"

# 2) Turn the cleaned-up still into a short motion clip
curl -X POST https://api.creativeai.run/v1/video/generations   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "auto",
    "image_url": "https://cdn.creativeai.run/output/clean-product-shot.png",
    "prompt": "Slow premium turntable shot of this product, subtle camera drift, soft studio reflections, ecommerce ad style",
    "duration": 5,
    "webhook_url": "https://your-app.com/webhooks/creativeai/video"
  }'

# 3) Generate the narration track
curl -X POST https://api.creativeai.run/api/generate/voice   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "text": "Meet the travel mug built for commutes, workouts, and long desk days. Leak-resistant, lightweight, and ready to go.",
    "voice": "alloy",
    "language": "en",
    "speed": 1.0,
    "webhook_url": "https://your-app.com/webhooks/creativeai/voice"
  }'

# 4) Merge the hosted voice track onto the hosted MP4
curl -X POST https://api.creativeai.run/api/generate/compose   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "video_url": "https://cdn.creativeai.run/output/product-motion.mp4",
    "audio_url": "https://cdn.creativeai.run/output/product-voice.mp3",
    "replace_audio": true,
    "webhook_url": "https://your-app.com/webhooks/creativeai/compose"
  }'

# Merge generated narration onto an existing video
# Step 1: submit a composition job
curl -X POST https://api.creativeai.run/api/generate/compose   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "video_url": "https://cdn.creativeai.run/output/product-demo.mp4",
    "audio_url": "https://cdn.creativeai.run/output/voice-abc123.mp3",
    "replace_audio": true,
    "webhook_url": "https://your-app.com/webhooks/creativeai/compose"
  }'

# Step 2: poll the shared async status endpoint if you are not using webhooks
curl https://api.creativeai.run/api/generate/status/comp_xyz789   -H "Authorization: Bearer YOUR_API_KEY"

# Chart-to-Video: Turn financial charts into animated investor videos
# Step 1: Submit chart-to-video job with image or data
curl -X POST https://api.creativeai.run/api/generate/chart-to-video   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "chart_image_url": "https://example.com/charts/q4-revenue.png",
    "animation_style": "ken_burns",
    "title": "Q4 Revenue Growth",
    "duration": 10,
    "webhook_url": "https://your-app.com/webhooks/creativeai/chart-video"
  }'

# Alternative: Data-driven chart generation
curl -X POST https://api.creativeai.run/api/generate/chart-to-video   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "chart_data": {
      "type": "line",
      "labels": ["Q1", "Q2", "Q3", "Q4"],
      "datasets": [{"label": "Revenue", "data": [1.2, 1.8, 2.4, 3.1]}]
    },
    "animation_style": "build_up",
    "title": "Revenue Trajectory",
    "duration": 8
  }'

# Step 2: Poll the shared async status endpoint
curl https://api.creativeai.run/api/generate/status/chart_xyz123   -H "Authorization: Bearer YOUR_API_KEY"