---
title: "Create Higgsfield Seedance 2.5 video generation job"
method: POST
path: "/generate/videos"
---

# Create Higgsfield Seedance 2.5 video generation job

`POST /generate/videos`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/generate/videos`
- Auth: HTTP bearer

Queues a paid video request. Supplying image_url or an official likeness reference uses Seedance 2.5 image-to-video to preserve the approved source identity; text-only requests use text-to-video. Successful jobs return a BAMF-hosted MP4 media asset and a provider request ID; failed, cancelled, or moderated requests are not reported as successful.

## Request body

- GenerateVideoRequest
  - `creator_id` string, uuid, required
  - `prompt` string, required
  - `duration` 5 | 10
  - `resolution` '480p' | '720p' | '1080p'
  - `aspect_ratio` '16:9' | '9:16' | '1:1'
  - `generate_audio` boolean
  - `provider_policy` 'automatic' | 'higgsfield_only': Optional provider-routing constraint. higgsfield_only disables environment-forced Fal routing and automatic Fal fallback.
  - `image_url` string, uri: Optional approved start frame. When supplied, BAMF uses Seedance 2.5 image-to-video.
  - `reference_bindings` ReferenceBindingInput[]: Optional reference contract. The first official likeness image is used as the image-to-video start frame; inspiration references never establish identity. (unresolved $ref)

## Response `202`

Video generation job queued

- ApiJobResponse
  - `data` ApiJob
    - `id` string
    - `job_type` 'post.generate' | 'post.edit' | 'image.generate' | 'carousel.generate' | 'carousel.pdf' | 'brand_kit.generate' | 'research.run' | 'knowledge.process' | 'analytics.sync'
    - `status` 'queued' | 'running' | 'succeeded' | 'completed' | 'failed' | 'cancelled' | 'canceled'
    - `creator_id` string
    - `input` unknown
    - `output` unknown
    - `error` unknown
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable

## Other responses

- `400`: Invalid video generation input

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/2337a0710c2e?raw)