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.
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 secondsEjemplo 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'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ámetro | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| prompt | string | Sí | Texto descripción imagen, máx 300 caracteres | A sunset over mountains |
| model | string | Sí | Nombre modelo: seedream-3.0, seedream-4.0, seedream-4.5, seedream-5.0 | seedream-4.5 |
| resolution | string | No | Resolución salida: 1024x1024, 2048x2048, 4k (4096×4096) | 4k |
| quality | string | No | Calidad generación: standard, high | high |
| num_images | integer | No | Número imágenes a generar, 1-4 | 1 |
| seed | integer | No | Semilla aleatoria para resultados reproducibles | 42 |
| style | string | No | Estilo arte: oil_painting, watercolor, cyberpunk, etc. | oil_painting |
Parámetros Generación Video Seedance
| Parámetro | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| prompt | string | Sí | Texto descripción video, máx 300 caracteres | Running through forest |
| model | string | Sí | Nombre modelo: seedance-1.0, seedance-1.5-pro, seedance-2.0 | seedance-1.5-pro |
| duration | integer | Sí | Duración video en segundos, 5-30s | 15 |
| resolution | string | No | Resolución salida: 720p, 1080p, 4k | 1080p |
| fps | integer | No | Tasa de fotogramas: 24, 30, 60 | 24 |
| image_input | string | No | URL imagen referencia (opcional) para imagen-a-video | https://... |
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 HTTP | Código Error | Descripción | Acción Sugerida |
|---|---|---|---|
| 400 | INVALID_REQUEST | Parámetros solicitud inválidos o faltantes | Verificar formato parámetros solicitud y campos requeridos |
| 401 | UNAUTHORIZED | Clave API inválida o expirada | Verificar que clave API sea correcta |
| 403 | FORBIDDEN | Sin permiso para acceder este recurso | Actualizar cuenta o contactar soporte |
| 429 | RATE_LIMITED | Límite tasa excedido | Esperar y reintentar, verificar encabezados límite tasa |
| 500 | INTERNAL_ERROR | Error interno servidor | Reintentar más tarde o contactar soporte técnico |
| 503 | SERVICE_UNAVAILABLE | Servicio temporalmente no disponible | Usar 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
Adecuado para pruebas personales y uso pequeña escala
Adecuado para aplicaciones pequeñas a medianas y equipos desarrollo
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
Registrar Cuenta
Visitar seedance2api.com para registrar nueva cuenta
- 2
Verificar Email
Completar verificación email para activar cuenta
- 3
Ir a Consola
Después iniciar sesión, ir a consola desarrollador
- 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. Configurar URL Webhook en consola
- 2. Seleccionar tipos eventos a recibir
- 3. Verificar firma Webhook para seguridad
- 4. Agregar parámetro webhook_url en solicitud
Información Créditos Gratuitos
Obtener $1 crédito en primera vinculación tarjeta
Recibido automáticamente al verificar cuenta
Obtener 25% bonificación en primer depósito
Obtener 25% bonificación en cualquier monto primer depósito
Período Prueba Días
Nuevos usuarios obtienen prueba gratuita 30 días
Vista Previa Precios
Planes precios flexibles para satisfacer necesidades desde desarrolladores individuales hasta empresas
Preguntas Frecuentes
Encuentra respuestas a tus preguntas rápidamente