ByteDance: Seedance 1.0 Pro
Seedance 1.0 Pro genera vídeo sin sonido a partir de texto o de una imagen inicial. Describe la acción y la cámara, o anima una composición existente, con una duración de 2–12 segundos, 24 fps y controles explícitos del encuadre y la resolución de salida.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
Seedance 1.0 Pro genera un vídeo a partir de texto o de una escena guiada por una imagen. El selector doubao-seedance-1-0-pro-250528 admite ambos modos de entrada, así que el punto de partida puede ser un concepto escrito o una composición visual existente. Utiliza instrucciones de texto para crear una escena nueva, o proporciona una imagen cuando el sujeto, su disposición y la vista inicial deban establecerse visualmente. Este perfil 1.0 produce vídeo sin sonido; el sonido sincronizado corresponde al perfil 1.5 Pro descrito por separado.
Para generar de texto a vídeo, especifica el sujeto, el entorno, el movimiento, el encuadre y la cámara en una escena coherente. El ejemplo documentado avanza gradualmente desde un campo de margaritas hasta un primer plano de una flor con rocío en los pétalos. Esa estructura sirve para otras presentaciones progresivas: establece el entorno, acércate al sujeto y termina en el detalle importante. Para un concepto de producto, describe el material y la iluminación, además de la acción, y asigna a la cámara un recorrido realizable en el plano corto.
Para generar de imagen a vídeo, coloca la referencia en un elemento image_url de content y explica qué debe cambiar desde esa vista inicial. Un retrato preparado puede definir la persona y el recorte, mientras que las instrucciones describen un pequeño giro, el movimiento del pelo o un suave alejamiento de cámara. Una imagen fija de producto puede establecer el objeto y el fondo, mientras que las instrucciones piden mostrarlo de forma controlada. Mantén el movimiento solicitado compatible con la composición de origen; una imagen de un lado del objeto no proporciona una vista precisa de todos los demás lados que no se ven.
El campo de imagen acepta una URL accesible o una URL de datos que contenga datos de imagen Base64. Los formatos documentados son JPEG, PNG, WEBP, BMP, TIFF y GIF. Las imágenes deben ocupar menos de 30 MB, tener una relación entre ancho y alto estrictamente entre 0.4 y 2.5, y cada dimensión debe estar estrictamente entre 300 y 6000 píxeles. Prepara una imagen de origen clara con el recorte previsto, en lugar de depender de una miniatura que ya carece de los detalles que la definen. Para generar de imagen a vídeo, la guía recomienda un encuadre adaptativo que siga las proporciones de la referencia.
La duración documentada de 1.0 es de dos a doce segundos y la frecuencia de fotogramas es de 24 fps. Los controles de salida incluyen niveles de 480p, 720p y 1080p, con 1080p como valor predeterminado de Pro; la guía excluye 1080p en el supuesto de imagen de referencia. Los formatos fijos incluyen 16:9, 4:3, 1:1, 3:4, 9:16 y 21:9. Elige una combinación compatible con imágenes para un plano guiado por una imagen, en lugar de trasladar sin cambios todos los ajustes de texto a vídeo. Revisa el encuadre real devuelto antes de colocar el clip en una composición.
Los controles seed y watermark se documentan junto con camerafixed. La instrucción de cámara fija no se admite en el supuesto de imagen de referencia y, cuando sí se aplica, la guía no garantiza una cámara perfectamente inmóvil. Las instrucciones de parámetros incluidas en el texto tienen prioridad sobre los campos opcionales separados. Mantén un único ajuste de referencia para duración, resolución y relación de aspecto, y haz que la descripción de cámara concuerde con él. Así se evita que las instrucciones de la escena anulen sin advertirlo los ajustes seleccionados para la solicitud.
El uso se mide en tokens de vídeo: ancho de salida × alto de salida × frecuencia de fotogramas × duración de salida / 1024. La tarea completada comunica esta cantidad como usage.completion_tokens. Conserva el uso comunicado junto con el clip terminado y los ajustes solicitados.
El flujo de trabajo devuelve primero un identificador de tarea y, tras el procesamiento, la ubicación del vídeo terminado. Conserva el identificador mientras compruebas si está en cola o en ejecución; una tarea con estado succeeded proporciona content.video_url e información de uso. El periodo documentado de conservación de los archivos generados es de siete días. Guarda el clip terminado, la imagen de origen y las instrucciones exactas como registro de revisión; después, examina el aspecto del sujeto, el movimiento, la continuidad de la imagen y la composición final a lo largo de todo el resultado.
Ailoot Ultra · Vídeo POST /v1/videos doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528Primeros pasos
Seedance 1.0 Pro genera vídeo sin sonido a partir de texto o de una imagen inicial. Describe la acción y la cámara, o anima una composición existente, con una duración de 2–12 segundos, 24 fps y controles explícitos del encuadre y la resolución de salida.
- Entradas aceptadas
- Texto · Imágenes
- Resultados
- Vídeo
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Vídeo POST /v1/videos
- Tipos de entrada
text,image- Tipos de salida
video
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites doubao-seedance-1-0-pro-250528 | Predeterminado— |
Campocontent | Tipoarray | RequisitoObligatorio | Valores y límites Condiciones: Objetos nativos de texto o medios; la lista exterior no puede estar vacía. Este constructor genérico de Ailoot no valida los tipos de los nodos anidados. | Predeterminado— |
Campoduration | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 2 Máximo: 12 Condiciones: El esquema principal de 1.x indica 2–12; una descripción compartida posterior indica 4–12 o -1 para 1.5. El ejemplo usa 5, documentado en ambos casos. | Predeterminado5 |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites Condiciones: Los valores confirmados para generar vídeo a partir de texto son 480p y 1080p. La entrada mediante imagen de referencia excluye 1080p. El valor 720p de la enumeración compartida contradice la descripción específica del modelo, por lo que la compatibilidad con 720p sigue sin resolverse en ambos modos. | Predeterminado1080p |
Camporatio | Tipostring | RequisitoOpcional | Valores y límites 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Condiciones: Valores predeterminados según la escena y el modelo; la documentación de entrada mediante imagen recomienda adaptive. | Predeterminado— |
Camposervice_tier | Tipostring | RequisitoOpcional | Valores y límites default, flex Condiciones: default=online, flex=offline; elige antes de la creación. | Predeterminadodefault |
Camposeed | Tipointeger | RequisitoObligatorio | Valores y límites Mínimo: -1 Máximo: 4.294.967.295 | Predeterminado-1 |
Campocamerafixed | Tipoboolean | RequisitoObligatorio | Valores y límites Condiciones: Obligatorio en Ailoot; la documentación indica que el control de cámara mediante imagen de referencia no es compatible y no garantiza su efecto. | Predeterminadofalse |
Campowatermark | Tipoboolean | RequisitoObligatorio | Valores y límites | Predeterminadofalse |
Campoexecution_expires_after | Tipointeger | RequisitoObligatorio | Valores y límites Mínimo: 3600 Máximo: 259.200 Unidad: segundos | Predeterminado172.800 |
Combinaciones de materiales de entrada
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratocamerafixed, content, execution_expires_after, model, seed, watermark |
Parámetrooptional | Contratoduration, resolution, ratio, service_tier |
Parámetromaterial_types | Contratotext, image |
Parámetroadditional_properties | Contratotrue |
Parámetrovalidation_scope | ContratoAiloot comprueba los tipos de los campos obligatorios y que model y la lista content no estén vacíos. Los demás campos de la solicitud se conservan para el modelo seleccionado. |
Parámetroimage_constraints | Contrato{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null} |
Alias de método: /v1/videos/generations
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Crea una sola vez y conserva el id público devuelto y polling_url.
Consulta periódicamente el trabajo original; descarga el content.video_url real bajo tu titularidad después de succeeded.
Planes
Cómo se calcula el cargo definitivo
Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Tarifas estimadas para comparar
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad prevista | Unidad de facturación | Cargo |
|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Unidad de facturación— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens |
| ConfiguraciónUltra | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor 1K tokens de vídeo | Cargo Salida · Estimación solo para comparar $0.0044 por 1K tokens de vídeo |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.2112 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija para la generación completada. |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Vídeo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-250528","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
index=$((index + 1))
done < asset-urls.txt
Recibir y guardar resultados
Ailoot Ultra · Vídeo
JSON nativo con id público y polling_url. Tras la publicación, content.video_url contiene una o varias URL firmadas de recursos bajo titularidad de Ailoot; antes de la publicación se vacían las URL de salida seleccionadas.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Conserva todos los resultados completados
Guarda todos los vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva todas las URL reales de content.video_url; index debe identificar un resultado real devuelto.
Si es necesario revisar la respuesta original
Conserva la respuesta, las cabeceras y el id originales y consulta periódicamente esa operación; no vuelvas a enviar nunca una creación de resultado desconocido.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campoprovider_task_id | Tipostring |
Campopolling_url | Tipostring |
Campostatus | Tipostring when supplied |
Campocontent.video_url | Tipostring|string[] |
Campousage | Tipoobject when supplied |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónJSON, modelo, tipos de campos obligatorios o índice de contenido no válidos. | Siguiente paso |
Respuesta401 · authentication_error | CondiciónClave API de Ailoot no válida. | Siguiente paso |
Respuesta404 · not_found_error | CondiciónLa tarea o el resultado no existe o no pertenece al mismo usuario, clave API o grupo. | Siguiente paso |
Respuesta502 · result_pending_check | CondiciónEnvío o estado original incompleto; conserva el ID original y no vuelvas a enviarlo. | Siguiente paso |
Respuesta503 · result_pending_check | CondiciónLos medios, la ruta o la liquidación originales están en comprobación; continúa la operación original. | Siguiente paso |
Alias
Alias del modelo
Ailoot Ultra doubao-seedance-1-0-pro-250528
Alias de rutas de métodos
/v1/videos/generations
ID de modelo relacionados
FAQ · ByteDance: Seedance 1.0 Pro
- ¿Qué entradas y resultados están disponibles?
POST /v1/videos·doubao-seedance-1-0-pro-250528:text,image→video- ¿Qué campos utiliza la solicitud?
POST /v1/videos·doubao-seedance-1-0-pro-250528:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- ¿Qué límites se aplican?
POST /v1/videos·doubao-seedance-1-0-pro-250528:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200