ByteDance: Seedance 1.0 Pro
Seedance 1.0 Pro genera video 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 video 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 video sin sonido; el sonido sincronizado corresponde al perfil 1.5 Pro descrito por separado.
Para generar de texto a video, 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 video, 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 cabello 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 video, 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 video. 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 video: 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 video 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 · Generación de video POST /v1/videos doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528Inicio
Seedance 1.0 Pro genera video 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
- Video
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Generación de video POST /v1/videos
- Entrada
text,image- 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 contenido multimedia; el arreglo exterior no debe estar vacío. 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: Esquema principal de 1.x: 2–12; una descripción compartida posterior indica 1.5 como 4–12 o -1. El ejemplo usa 5, documentado en ambos casos. | Predeterminado5 |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites Condiciones: Los valores confirmados para texto a video son 480p y 1080p. La entrada con imagen de referencia excluye 1080p. El valor 720p del conjunto compartido contradice el texto específico 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 con imagen recomienda adaptive. | Predeterminado— |
Camposervice_tier | Tipostring | RequisitoOpcional | Valores y límites default, flex Condiciones: default=online, flex=offline; elige antes de crear. | 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 para Ailoot; la documentación indica que el control de cámara con imagen de referencia no es compatible y su efecto no está garantizado. | Predeterminadofalse |
Campowatermark | Tipoboolean | RequisitoObligatorio | Valores y límites | Predeterminadofalse |
Campoexecution_expires_after | Tipointeger | RequisitoObligatorio | Valores y límites Mínimo: 3,600 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 verifica los tipos de los campos obligatorios y que el modelo y el arreglo de contenido 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/polling_url público devuelto.
Consulta periódicamente el trabajo original; descarga el contenido real content.video_url que te pertenece después de succeeded.
Tarifas
Cómo se calcula el cargo definitivo
Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son 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 fast
- Sin especificar Cuando se selecciona el modo fast
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste 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 video | Cargo Salida · Estimación solo para comparar $0.0044 por 1K tokens de video |
| ConfiguraciónCosto estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Cargo Salida · Costo 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 por la generación completada. |
Ailoot reserva un monto 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 · Generación de video
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 · Generación de video
JSON nativo con id/polling_url públicos. Después de la publicación, content.video_url contiene URL firmadas bajo control de Ailoot; antes de la publicación, las URL de salida seleccionadas se dejan vacías.
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 videos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva cada URL real en content.video_url; index debe identificar una salida real devuelta.
Si es necesario revisar la respuesta original
Conserva la respuesta, los encabezados y el id originales y consulta periódicamente esa operación; nunca vuelvas a enviar 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 salida no existe o no pertenece al mismo usuario, clave API y grupo. | Siguiente paso |
Respuesta502 · result_pending_check | CondiciónEnvío o estado original incompleto; conserva el ID original, sin reenviar. | Siguiente paso |
Respuesta503 · result_pending_check | CondiciónSe verifican el contenido multimedia, la ruta o la liquidación originales; 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