seedance-2.5 API

Utilice el ID de modelo exacto seedance-2.5. El campo del modelo debe coincidir exactamente con esta página.

Salida de muestraseedance-2.5POST /v1/videos5.1s

Parámetros: duration=5resolution=1080pratio=16:9

Prompt: A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

Solicitud que produjo esta muestra

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Autenticación y punto final

Utilice una clave API de Modelflare con https://modelflare.dev/v1. El punto de entrada de la puerta de enlace es POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Crear una tarea

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

Encuesta y descarga

Guardar el ID de la tarea. Sondear GET /v1/videos/{task_id} y descargar con GET /v1/videos/{task_id}/content. Las URL de resultados pueden caducar, así que transfiera el archivo lo antes posible.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Solicitar notas

Seedance utiliza content[] para texto, marcos y medios de referencia; el contrato separado Gestión de activos de Seedance se documenta de forma independiente.

Nota

Sube primero las imágenes de personas virtuales a la biblioteca de recursos de Seedance. Espera a que el estado sea Active y utiliza asset://<ID> en content[]. Modelflare no ofrece verificación de personas reales.

Solicitar parámetros

Seedance utiliza una envolvente multimodal asíncrona. Poner texto y medios en content[]; Los roles de medios seleccionan el primer/último fotograma o flujos de trabajo de referencia.

Campo	Requerido	Notas
model	Sí	seedance-2.5
content[]	Sí	text, image_url, video_url y audio_url; Utilice role para identificar el propósito de los medios.
resolution	No	480p / 720p / 1080p
ratio	No	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	No	-1 para sincronización automática, o 4–30 segundos
generate_audio	No	Genera diálogos, efectos y audio de fondo sincronizados
tools	No	Utilice web_search solo donde la página oficial del modelo lo admita
watermark	No	Si se debe agregar una marca de agua
omni_reference_task_type	No	auto / reference / edit / extend; la edición y la extensión imponen reglas de relación/duración más estrictas
output_format	No	mp4 / mov
return_last_frame	No	Devolver el fotograma final como imagen

Límites de entrada y salida

Este modelo admite 480p, 720p y 1080p. Utilice -1 para la sincronización automática o elija entre 4 y 30 segundos. Una solicitud puede combinar hasta 30 imágenes, 10 vídeos y 10 clips de audio. La generación de referencia ordinaria acepta una relación explícita o adaptive; los flujos de trabajo de edición, extensión y primer/último fotograma requieren ratio: "adaptive", y la edición requiere duration: -1. Las imágenes de personas virtuales deben subirse primero a la biblioteca de recursos; Modelflare no ofrece verificación de personas reales.

Ejemplos de flujos de trabajo documentados

Seedance 2.5 clasifica los flujos de trabajo guiados por referencias, edición, extensiones y cuadros según los roles de medios y el tipo de tarea. Los ejemplos mantienen el contrato oficial mientras utilizan el punto final y la identificación del modelo de Modelflare.

Referencia multimodal

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"@image1 performs the movement from @video1, paced to @audio1"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

Edición de vídeo

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

Extensión de vídeo

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

Primer y último fotograma

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

Errores y tareas fallidas

Los parámetros del modelo no válidos devuelven un 4xx con un ID de solicitud. Una tarea asincrónica también puede fallar después de que la creación sea exitosa; utilice error_code y error_message de la respuesta de la encuesta como motivo final de la tarea. No vuelva a intentar la misma solicitud con una forma JSON diferente.

Alcance soportado

Esta página cubre las llamadas de generación y edición de modelos de Modelflare. El enriquecimiento de mapas o búsquedas, la administración de voz y la administración de bibliotecas de elementos son API de recursos fuera de esta superficie pública de llamada de modelo y no son campos de solicitud obligatorios.

Precios y facturación

Este modelo utiliza facturación basada en tokens. Consulte la página de precios de modelos para conocer el precio actual para el cliente, el precio de lista de referencia y las especificaciones completas.

Nota

Esta página documenta la interfaz pública de Modelflare; Los campos y límites que se muestran aquí son el contrato actual.

Variantes

ID del modelo	Diferencia
seedance-2.5	El modelo documentado en esta página.