Powerful and Easy-to-Use AI API

pip install seedance-sdk

poetry add seedance-sdk

npm install seedance-sdk

yarn add seedance-sdk

import seedance

# Initialize client
client = seedance.Client(api_key="your-api-key-here")

# Or use environment variable
# export SEEDANCE_API_KEY="your-api-key"
# client = seedance.Client()

# Generate high-quality images using Seedream 4.5
response = client.seedream.generate(
    prompt="A serene mountain landscape at sunset, oil painting style",
    model="seedream-4.5",
    resolution="4k",
    quality="high",
    num_images=1,
    seed=42  # Optional: for reproducible results
)

# Get results
image_url = response.images[0].url
print(f"Generated image: {image_url}")

# Generate video using Seedance 1.5 Pro
response = client.seedance.generate(
    prompt="A majestic eagle soaring over snowy mountains",
    model="seedance-1.5-pro",
    duration=15,  # seconds
    resolution="1080p",
    fps=24
)

# Get async task ID
task_id = response.task_id
print(f"Task submitted: {task_id}")

import time

# Poll task status
while True:
    status = client.task.get_status(task_id)

    if status.status == "completed":
        result = status.result
        print(f"Video URL: {result.video_url}")
        break
    elif status.status == "failed":
        print(f"Task failed: {status.error_message}")
        break
    else:
        print(f"Task status: {status.status}")
        time.sleep(2)  # Check every 2 seconds

import { SeedanceClient } from 'seedance-sdk';

// Initialize client
const client = new SeedanceClient({
  apiKey: 'your-api-key-here'
});

// Or use environment variable
// const client = new SeedanceClient();

// Generate images using Seedream 4.5
const response = await client.seedream.generate({
  prompt: "A cyberpunk city street with neon signs",
  model: "seedream-4.5",
  resolution: "4k",
  quality: "high",
  numImages: 1
});

// Get results
const imageUrl = response.images[0].url;
console.log(`Generated image: ${imageUrl}`);

// Generate video using Seedance 1.5 Pro
const response = await client.seedance.generate({
  prompt: "A spacecraft entering Earth's atmosphere",
  model: "seedance-1.5-pro",
  duration: 20,  // seconds
  resolution: "1080p",
  fps: 24
});

// Get task ID
const taskId = response.taskId;
console.log(`Task submitted: ${taskId}`);

// Use waitForCompletion helper function
const result = await client.task.waitForCompletion(taskId, {
  maxWaitTime: 300000,  // 5 minutes
  pollInterval: 2000    // Check every 2 seconds
});

if (result.status === 'completed') {
  console.log(`Video URL: ${result.videoUrl}`);
} else {
  console.error(`Task failed: ${result.errorMessage}`);
}

{
  "status": "success",
  "data": {
    "task_id": "task-uuid-12345",
    "images": [
      {
        "id": "img-uuid-001",
        "url": "https://cdn.seedance2api.com/images/...",
        "width": 2048,
        "height": 2048,
        "format": "png",
        "size_bytes": 4526048
      }
    ],
    "model": "seedream-4.5",
    "resolution": "4k",
    "processing_time_ms": 2500
  }
}

{
  "status": "accepted",
  "data": {
    "task_id": "task-uuid-67890",
    "status": "queued",
    "estimated_wait_time_seconds": 45,
    "check_status_url": "/v1/tasks/task-uuid-67890"
  }
}

{
  "status": "error",
  "error": {
    "code": "INVALID_PROMPT",
    "message": "Prompt is too long (max 300 characters)",
    "details": {
      "field": "prompt",
      "value": "...",
      "constraint": "max_length",
      "limit": 300
    }
  }
}

{
  "status": "error",
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API key is invalid or expired"
  }
}

HTTP/1.1 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1705315200
X-RateLimit-RetryAfter: 3600

# Explanation:
# X-RateLimit-Limit: Total quota for current period
# X-RateLimit-Remaining: Remaining requests
# X-RateLimit-Reset: Quota reset timestamp
# X-RateLimit-RetryAfter: Recommended retry wait time in seconds

# Method 1: Using Authorization header
curl -X POST https://api.seedance2api.com/v1/seedream/generate \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "..."}'

# Method 2: Using X-API-Key header
curl -X POST https://api.seedance2api.com/v1/seedream/generate \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "..."}'