API para Desarrolladores

API IA Potente y Fácil de Usar

Solución completa de generación IA de video e imagen

Integra los modelos Seedance y Seedream de clase mundial, genera videos e imágenes profesionales con un clic. Soporta múltiples SDK, solo unas líneas de código.

1000+
Desarrolladores confían
99.9%
Tiempo de actividad
<100ms
Tiempo respuesta promedio
24/7
Soporte técnico

Modelos IA Soportados

Seedance 1.0

Básico
  • Generación video 720P
  • Máximo 5 segundos
  • Texto a video
  • Procesamiento rápido

Seedance 1.5 Pro

Recomendado
  • Generación video 1080P
  • Máximo 30 segundos
  • Imagen y video a video
  • Opciones control avanzadas
  • Recorte IA
  • Reemplazo fondo

Seedance 2.0

Nuevo
  • Generación video 4K
  • Máximo 60 segundos
  • Efectos avanzados
  • Procesamiento tiempo real

Seedream 3.0

Imagen
  • Generación imagen 2K
  • Estilos diversos
  • Renderizado rápido
  • Control creativo

Seedream 4.0

Avanzado
  • Generación imagen 4K
  • Salida alta fidelidad
  • Mejora detalles
  • Generación variantes

Seedream 4.5

Último
  • Generación imagen 8K
  • Ultra alta resolución
  • Mejora procesamiento IA
  • Calidad profesional

Seedream 5.0

Vanguardia
  • Soporte imagen 16K
  • Procesamiento detalles extremos
  • Optimización inteligente IA
  • Soporte funciones experimentales

Por qué elegir nuestra API

Procesamiento Ultra Rápido

Pipeline de procesamiento optimizado, tiempo de respuesta <100ms, latencia de milisegundos.

Seguridad Empresarial

Cifrado de extremo a extremo, certificación ISO 27001, protección de privacidad empresarial.

Privacidad de Datos

Cumplimiento estricto GDPR, datos de usuario eliminados automáticamente en 30 días.

Alta Confiabilidad

Garantía de tiempo de actividad 99.9%, despliegue multi-región global.

Escalabilidad Ilimitada

Arquitectura de escalado automático, soporta cualquier tráfico, sin preocupaciones de capacidad.

Documentación Completa

Documentación API detallada, ejemplos SDK, guías de mejores prácticas.

Instalación SDK

Guía de Inicio Rápido

Python SDK

Instalar vía pip

pip install seedance-sdk

Instalar vía poetry

poetry add seedance-sdk

Node.js SDK

Instalar vía npm

npm install seedance-sdk

Instalar vía yarn

yarn add seedance-sdk

Guía de Inicio Rápido

Ejemplo Python

Inicializar cliente

Configuración básica

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()

Generar imagen

Generación imagen Seedream

# 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}")

Generar video

Generación video Seedance

# 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}")

Verificar estado de tarea

Sondear resultados

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

Ejemplo Node.js / TypeScript

Inicializar cliente

Configuración básica

import { SeedanceClient } from 'seedance-sdk';

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

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

Generar imagen

Generación imagen Seedream

// 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}`);

Generar video

Generación video Seedance

// Generate video using Seedance 1.5 Pro
const response = await client.seedance.generate({
  prompt: "A spacecraft entering Earth&apos;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}`);

Espera asíncrona

Esperar finalización

// 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}`);
}

Uso REST API

Ejemplos Solicitud cURL

Generar Imagen

POST /v1/seedream/generate

curl -X POST https://api.seedance2api.com/v1/seedream/generate \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A beautiful sunset over the ocean",
    "model": "seedream-4.5",
    "resolution": "4k",
    "quality": "high",
    "num_images": 1
  }' | jq '.images[0].url'

Generar Video

POST /v1/seedance/generate

curl -X POST https://api.seedance2api.com/v1/seedance/generate \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A runner jogging through a forest",
    "model": "seedance-1.5-pro",
    "duration": 15,
    "resolution": "1080p",
    "fps": 24
  }' | jq '.task_id'

Verificar Estado Tarea

GET /v1/tasks/:task_id

curl -X GET https://api.seedance2api.com/v1/tasks/task-123-abc \
  -H "Authorization: Bearer your-api-key" | jq '.'

# Response example:
# {
#   "task_id": "task-123-abc",
#   "status": "processing",
#   "progress": 45,
#   "created_at": "2024-01-15T10:30:00Z",
#   "updated_at": "2024-01-15T10:32:15Z"
# }

Obtener Resultado Final

GET /v1/results/:task_id

curl -X GET https://api.seedance2api.com/v1/results/task-123-abc \
  -H "Authorization: Bearer your-api-key" | jq '.'

# Response example:
# {
#   "task_id": "task-123-abc",
#   "status": "completed",
#   "result": {
#     "video_url": "https://cdn.seedance2api.com/videos/...",
#     "duration": 15,
#     "resolution": "1080p"
#   },
#   "completed_at": "2024-01-15T10:35:00Z"
# }

Detalles de Parámetros API

Descripciones completas de parámetros y ejemplos

Parámetros Generación Imagen Seedream

ParámetroTipoRequeridoDescripciónEjemplo
promptstringTexto descripción imagen, máx 300 caracteresA sunset over mountains
modelstringNombre modelo: seedream-3.0, seedream-4.0, seedream-4.5, seedream-5.0seedream-4.5
resolutionstringNoResolución salida: 1024x1024, 2048x2048, 4k (4096×4096)4k
qualitystringNoCalidad generación: standard, highhigh
num_imagesintegerNoNúmero imágenes a generar, 1-41
seedintegerNoSemilla aleatoria para resultados reproducibles42
stylestringNoEstilo arte: oil_painting, watercolor, cyberpunk, etc.oil_painting

Parámetros Generación Video Seedance

ParámetroTipoRequeridoDescripciónEjemplo
promptstringTexto descripción video, máx 300 caracteresRunning through forest
modelstringNombre modelo: seedance-1.0, seedance-1.5-pro, seedance-2.0seedance-1.5-pro
durationintegerDuración video en segundos, 5-30s15
resolutionstringNoResolución salida: 720p, 1080p, 4k1080p
fpsintegerNoTasa de fotogramas: 24, 30, 6024
image_inputstringNoURL imagen referencia (opcional) para imagen-a-videohttps://...

Ejemplos Formato Respuesta

Estructura respuesta JSON estandarizada

Respuesta Exitosa

Generación Imagen Exitosa

{
  "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
  }
}

Generación Video Aceptada

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

Respuesta Error

Solicitud Incorrecta (400)

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

No Autorizado (401)

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

Guía Manejo Errores

Código Estado HTTPCódigo ErrorDescripciónAcción Sugerida
400INVALID_REQUESTParámetros solicitud inválidos o faltantesVerificar formato parámetros solicitud y campos requeridos
401UNAUTHORIZEDClave API inválida o expiradaVerificar que clave API sea correcta
403FORBIDDENSin permiso para acceder este recursoActualizar cuenta o contactar soporte
429RATE_LIMITEDLímite tasa excedidoEsperar y reintentar, verificar encabezados límite tasa
500INTERNAL_ERRORError interno servidorReintentar más tarde o contactar soporte técnico
503SERVICE_UNAVAILABLEServicio temporalmente no disponibleUsar mecanismo reintento retroceso exponencial

Mejores Prácticas

  • Implementar estrategia reintento retroceso exponencial
  • Establecer tiempo espera razonable (recomendado 5 minutos)
  • Usar sondeo o Webhook para resultados generación video
  • Registrar todos errores API para depuración
  • Usar Webhook para evitar sondeo frecuente

Limitación Tasa

Descripciones cuota solicitud para diferentes planes

Límites Solicitud

Plan Gratuito10 solicitudes/hora

Adecuado para pruebas personales y uso pequeña escala

Plan Pro1000 solicitudes/hora

Adecuado para aplicaciones pequeñas a medianas y equipos desarrollo

Plan EmpresarialIlimitado

Adecuado para entornos producción gran escala, cuotas personalizadas

Encabezados Respuesta

Encabezados Respuesta Límite Tasa

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

Autenticación - Clave API

Cómo Obtener Clave API

  1. 1

    Registrar Cuenta

    Visitar seedance2api.com para registrar nueva cuenta

  2. 2

    Verificar Email

    Completar verificación email para activar cuenta

  3. 3

    Ir a Consola

    Después iniciar sesión, ir a consola desarrollador

  4. 4

    Generar Clave

    Generar nueva clave en página Claves API

Cómo Usar Clave API

Uso en Solicitudes HTTP

# 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": "..."}'

Consejos Seguridad

  • No exponer clave API en código cliente
  • Usar variables entorno para almacenar clave
  • Rotar claves regularmente
  • Si clave se filtra, eliminar inmediatamente y regenerar

Soporte Webhook

Notificaciones Tiempo Real

Configurar Webhook para recibir notificaciones finalización tarea, sin necesidad sondeo frecuente API. Soporta reintento automático y verificación firma.

  • Notificación automática finalización tarea
  • Notificación fallo
  • Actualización progreso (opcional)
  • Mecanismo reintento automático

Ejemplo Evento Webhook

{
  "event": "task.completed",
  "timestamp": "2024-01-15T10:35:00Z",
  "data": {
    "task_id": "task-uuid-12345",
    "status": "completed",
    "model": "seedance-1.5-pro",
    "result": {
      "video_url": "https://cdn.seedance2api.com/...",
      "duration": 15,
      "resolution": "1080p"
    }
  }
}

Cómo Configurar Webhook

  1. 1. Configurar URL Webhook en consola
  2. 2. Seleccionar tipos eventos a recibir
  3. 3. Verificar firma Webhook para seguridad
  4. 4. Agregar parámetro webhook_url en solicitud

Información Créditos Gratuitos

Bonificación Vinculación Tarjeta

Obtener $1 crédito en primera vinculación tarjeta

Recibido automáticamente al verificar cuenta

Bonificación Primer Depósito

Obtener 25% bonificación en primer depósito

Obtener 25% bonificación en cualquier monto primer depósito

30

Período Prueba Días

Nuevos usuarios obtienen prueba gratuita 30 días

Cómo Empezar

  1. 1Registrar una cuenta
  2. 2Completar verificación email
  3. 3Visitar Playground
  4. 4Comenzar a crear videos increíbles

Vista Previa Precios

Planes precios flexibles para satisfacer necesidades desde desarrolladores individuales hasta empresas

Pago por Uso

  • Seedream: $0.04/imagen
  • Seedance: Precios bajo demanda
  • Sin consumo mínimo
  • Pagar solo por lo que usas

Suscripción Mensual

Más Popular

  • Plan Pro: $99/mes
  • Plan Empresarial: $499/mes
  • Incluye cuota mensual
  • Soporte técnico prioritario

Plan Empresarial

  • Cuota personalizada
  • Soporte técnico dedicado
  • Garantía SLA
  • Servicios integración profesional

Preguntas Frecuentes

Encuentra respuestas a tus preguntas rápidamente

¿Listo para Comenzar?

Regístrate ahora, obtén clave API gratuita, comienza construir tu aplicación IA

Sin tarjeta crédito · Comenzar inmediatamente · Prueba gratuita 30 días