Saltar al contenido principal
POST
Envía con POST /v1/videos/generations, lee data[0].task_id y consulta GET /v1/tasks/{task_id}.
string
requerido
Usa Authorization: Bearer <token>, donde <token> es tu clave API de APIMart.

Parámetros de solicitud

string
requerido
Usa seedance-2-5-flash. También se admite doubao-seedance-2-5-flash. El nombre con punto seedance-2.5-flash no es compatible.
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
Una detección devuelve HTTP 400 (nsfw_content_detected) sin crear tarea ni cobrar la generación. No se revisan vídeos ni audios de referencia. La solicitud puede continuar si falla el servicio de moderación.
string
requerido
Prompt obligatorio. Referencia medios con @图片1 / @视频1 / @音频1; los índices empiezan en 1 y siguen el orden de cada matriz de medios.
string
predeterminado:"720p"
Solo 480p / 720p; valor predeterminado 720p. 1080p, 2k, 4k y otros valores devuelven HTTP 400 al enviar.
string
predeterminado:"adaptive"
Admite 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (predeterminado). Alias: aspect_ratio. Los fotogramas inicial/final, la edición y la extensión requieren adaptive.
integer
Segundos enteros 4–30; las solicitudes normales usan 5 si se omite. -1 permite duración automática. edit explícito solo acepta -1 u omisión, que se convierte en -1; la salida sigue la duración de origen. La duración automática reserva 30 segundos y se liquida según los tokens reales.
boolean
predeterminado:"true"
Generar sonido, true por defecto. Alias: audio. Controla la salida, no las referencias de entrada audio_urls.
boolean
predeterminado:"false"
Añadir marca de agua de generación por IA, false por defecto.
integer
Semilla aleatoria opcional. Repetirla no garantiza resultados idénticos.
string
predeterminado:"mp4"
Contenedor de salida: mp4 (predeterminado) o mov.
string
predeterminado:"auto"
auto (predeterminado), reference, edit o extend, solo en tareas con referencias. Los tipos explícitos activan las validaciones al enviar descritas a continuación.
string[]
Matriz de imágenes, todas como reference_image. Máximo 10 combinadas con image_with_roles. Usa este último campo para los fotogramas inicial y final.
object[]
Cada elemento incluye url y role. Roles: reference_image, first_frame (máximo 1), last_frame (máximo 1, junto al inicial). Máximo 10 imágenes con image_urls; evita roles contradictorios. Con video_urls / audio_urls, los fotogramas inicial/final se convierten en imágenes de referencia multimodal.
string[]
Máximo 5 vídeos, de 2–30 segundos cada uno y 30 segundos en total. Los vídeos de origen para edición deben durar 4–30 segundos.
string[]
Máximo 5 audios, de 2–30 segundos cada uno y 30 segundos en total. Se admiten referencias solo de audio, sin imágenes ni vídeos.
boolean
predeterminado:"false"
Con true, devuelve una imagen del último fotograma tras el éxito en data.result.videos[].last_frame_url.
Permitir búsquedas web según sea necesario; false por defecto.
object[]
Lista opcional de herramientas, por ejemplo [{"type":"web_search"}] para búsqueda web.
No se admiten draft / draft_task_id; elimínalos de la solicitud o recibirás HTTP 400. Para borradores usa Seedance 2.5.

Requisitos de los medios

Usa URL http(s) públicas o ID asset:// aprobados. La resolución de salida y los límites de píxeles del vídeo de entrada se validan por separado.

Tipos de tarea y restricciones

Una restricción inválida del tipo explícito devuelve HTTP 400 antes de crear la tarea o cobrar. Con auto, el modelo deduce el tipo de los medios y el prompt, por lo que puede fallar durante la generación. Un tipo explícito también puede producir InvalidParameter.TaskTypeMismatch si contradice el prompt.

Ejemplos de solicitudes

Referencia multimodal

Fotogramas inicial y final

Edición de vídeo

Extensión de vídeo

Recursos privados

Aprueba primero en la biblioteca las imágenes o vídeos con rostros reales y después usa asset://. En la carga, model también debe ser seedance-2-5-flash. Consulta la API de recursos y usa el nombre Flash del ejemplo.
Consulta la revisión con la API unificada de tareas. Tras la aprobación, obtén el ID asset:// de la lista y úsalo en image_urls, image_with_roles[].url, video_urls o audio_urls.

Estado y resultados

Consulta la API de estado. pending / processing indican progreso, completed éxito y failed fallo. Lee data.result.videos[0].url[0]; url es una matriz.

Facturación

  • Al enviar se reserva un importe con la tarifa por segundo de la resolución. Las referencias de vídeo usan el nivel con entrada y suman duración de salida y duración total de referencias.
  • Sin duration, una solicitud normal reserva 5 segundos de salida. duration: -1, o edit sin duración, reserva 30 segundos de salida.
  • Tras el éxito: data.usage.completion_tokens ÷ 1,000,000 × tarifa aplicable por millón de tokens, con descuentos de cuenta. Se reembolsa o cobra la diferencia. La presencia de vídeo de referencia determina token o token-input; el cargo final es data.cost.
  • Los envíos rechazados no generan cargos de generación. Si la generación falla, se reembolsa la reserva. Consulta la página de precios.

Errores frecuentes