> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Geração de vídeo Seedance 2.5 Flash

> Gere vídeos 480p / 720p de até 30 segundos com texto, referências multimodais, edição, extensão ou quadros inicial e final.

```bash cURL theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-5-flash",
  "prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 8,
  "generate_audio": true,
  "nsfw_check": true,
  "return_last_frame": true
}'
```

```python Python theme={null}
import requests

payload = {
  "model": "seedance-2-5-flash",
  "prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 8,
  "generate_audio": True,
  "nsfw_check": True,
  "return_last_frame": True
}
response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json=payload,
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

```javascript JavaScript theme={null}
const payload = {
  "model": "seedance-2-5-flash",
  "prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 8,
  "generate_audio": true,
  "nsfw_check": true,
  "return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
```

```json 200 theme={null}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_example_seedance25flash"
    }
  ]
}
```

Envie com `POST /v1/videos/generations`, leia `data[0].task_id` e consulte `GET /v1/tasks/{task_id}`.

**Authorization** `string` *required*

Use `Authorization: Bearer <token>`, onde `<token>` é sua chave de API APIMart.

## Parâmetros da requisição

**model** `string` *required*

Use `seedance-2-5-flash`. O alias `doubao-seedance-2-5-flash` também é aceito. O nome com ponto `seedance-2.5-flash` não é compatível.

**nsfw\_check** `boolean` (default: false)

Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.

* `true`: verificar prompts e imagens de entrada com `omni-moderation-latest`
* `false` ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)

Uma detecção retorna HTTP 400 (`nsfw_content_detected`) sem criar tarefa nem cobrar a geração. Vídeos e áudios de referência não são analisados. A requisição pode continuar se o serviço de moderação falhar.

**prompt** `string` *required*

Prompt obrigatório. Referencie mídias com `@图片1` / `@视频1` / `@音频1`; os índices começam em 1 e seguem a ordem de cada array de mídia.

**resolution** `string` (default: 720p)

Somente `480p` / `720p`; padrão `720p`. Valores como `1080p`, `2k` ou `4k` retornam HTTP 400 no envio.

**size** `string` (default: adaptive)

Aceita `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` (padrão). Alias: `aspect_ratio`. Quadros inicial/final, edição e extensão exigem `adaptive`.

**duration** `integer`

Segundos inteiros `4`–`30`; requisições comuns usam `5` quando omitido. `-1` ativa duração automática. `edit` explícito só aceita `-1` ou omissão, convertida em `-1`; a duração segue o vídeo de origem. A duração automática reserva 30 segundos e depois é liquidada pelos tokens reais.

**generate\_audio** `boolean` (default: true)

Gerar som, padrão `true`. Alias: `audio`. Controla a saída, separadamente do áudio de referência `audio_urls`.

**watermark** `boolean` (default: false)

Adicionar marca d’água de geração por IA, padrão `false`.

**seed** `integer`

Semente aleatória opcional. A mesma semente não garante resultados idênticos.

**output\_format** `string` (default: mp4)

Contêiner de saída: `mp4` (padrão) ou `mov`.

**omni\_reference\_task\_type** `string` (default: auto)

`auto` (padrão), `reference`, `edit` ou `extend`, apenas para tarefas com referências. Tipos explícitos ativam as verificações no envio descritas abaixo.

**image\_urls** `string[]`

Array de imagens, todas tratadas como `reference_image`. No máximo 10 combinadas com `image_with_roles`. Use este último para os quadros inicial e final.

**image\_with\_roles** `object[]`

Cada item contém `url` e `role`. Funções: `reference_image`, `first_frame` (máximo 1), `last_frame` (máximo 1, junto ao inicial). Máximo 10 imagens com `image_urls`; evite funções conflitantes. Com `video_urls` / `audio_urls`, os quadros inicial/final tornam-se imagens de referência multimodal.

**video\_urls** `string[]`

Até 5 vídeos, cada um com 2–30 segundos e no máximo 30 segundos no total. Vídeos de origem para edição devem ter 4–30 segundos.

**audio\_urls** `string[]`

Até 5 áudios, cada um com 2–30 segundos e no máximo 30 segundos no total. Referências somente de áudio são aceitas, sem imagem ou vídeo.

**return\_last\_frame** `boolean` (default: false)

Com `true`, retorna uma imagem do último quadro após o sucesso em `data.result.videos[].last_frame_url`.

**web\_search** `boolean` (default: false)

Permitir pesquisa na web conforme necessário, padrão `false`.

**tools** `object[]`

Lista opcional de ferramentas, por exemplo `[{"type":"web_search"}]` para pesquisa na web.

> [!WARNING]
>
> `draft` / `draft_task_id` não são compatíveis; remova-os ou o envio retornará HTTP 400. Para rascunhos, use [Seedance 2.5](https://docs.apimart.ai/pt/api-reference/videos/seedance-2-5/generation.md).

## Requisitos de mídia

Use URLs `http(s)` públicas ou IDs `asset://` aprovados. A resolução de saída e os limites de pixels do vídeo de entrada são verificados separadamente.

| Mídia | Limites |
| - | - |
| Imagens | ≤10 nos dois campos combinados; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF; largura e altura de 300–6000 px cada; proporção 0.4–2.5; `<30 MB` cada. |
| Vídeos | ≤5; MP4 / MOV, vídeo H.264 / H.265 e áudio AAC / MP3; 2–30 segundos cada, ≤30 segundos no total; ≤200 MB cada; largura e altura 300–6000 px, proporção 0.4–2.5, largura × altura 409,600–8,295,044 pixels, 24–60 FPS. |
| Áudio | ≤5; WAV / MP3; 2–30 segundos cada, ≤30 segundos no total; ≤15 MB cada. |

## Tipos de tarefa e restrições

| Modo | Uso e restrições |
| - | - |
| Texto para vídeo | Forneça `prompt` sem referências e omita `omni_reference_task_type`. |
| Referências para vídeo | Forneça referências; `reference` é opcional. Os limites normais de duração e proporção continuam válidos. |
| Quadros inicial/final | Use `image_with_roles`; `size` / `aspect_ratio` deve ser `adaptive`. |
| Edição de vídeo | `edit`; pelo menos 1 vídeo de origem de 4–30 segundos; proporção `adaptive`, `duration` em `-1` ou omitido. |
| Extensão de vídeo | `extend`; pelo menos 1 vídeo de referência; proporção `adaptive`. |

Restrições inválidas de um tipo explícito retornam HTTP 400 antes da criação ou cobrança. Com `auto`, o modelo deduz o tipo pelas mídias e pelo prompt, podendo falhar durante a geração. Mesmo um tipo explícito pode gerar `InvalidParameter.TaskTypeMismatch` se entrar em conflito com o prompt.

## Exemplos de requisições

### Referência multimodal

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Use the composition of @视频1, the subject in @图片1, and @音频1 as background music",
  "image_urls": [
    "https://example.com/reference.jpg"
  ],
  "video_urls": [
    "https://example.com/reference_8s.mp4"
  ],
  "audio_urls": [
    "https://example.com/music_5s.mp3"
  ],
  "omni_reference_task_type": "reference",
  "duration": 8,
  "size": "16:9"
}
```

### Quadros inicial e final

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Smoothly transition from the first frame to the last frame",
  "image_with_roles": [
    {
      "url": "https://example.com/first.jpg",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/last.jpg",
      "role": "last_frame"
    }
  ],
  "size": "adaptive",
  "duration": 5
}
```

### Edição de vídeo

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Edit @视频1: replace the cloudy sky with a clear sunset while preserving the camera movement",
  "video_urls": [
    "https://example.com/source_10s.mp4"
  ],
  "omni_reference_task_type": "edit",
  "size": "adaptive",
  "duration": -1,
  "output_format": "mov"
}
```

### Extensão de vídeo

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Extend @视频1 forward: continue the camera movement as the subject walks into the forest",
  "video_urls": [
    "https://example.com/source_10s.mp4"
  ],
  "omni_reference_task_type": "extend",
  "size": "adaptive",
  "duration": 5
}
```

## Recursos privados

Aprove primeiro na biblioteca as imagens ou vídeos com rostos reais e depois use `asset://`. No upload, `model` também deve ser `seedance-2-5-flash`. Consulte a [API de recursos](https://docs.apimart.ai/pt/api-reference/videos/seedance-2-0/private-avatar.md) e use o nome Flash abaixo.

```bash theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/seedance2/private-avatar/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-5-flash",
  "group": {
    "name": "flash-assets"
  },
  "asset_type": "Image",
  "assets": [
    {
      "url": "https://example.com/reference.jpg",
      "name": "reference"
    }
  ]
}'
```

Consulte a revisão pela API unificada de tarefas. Após a aprovação, obtenha o ID `asset://` na lista de recursos e use-o em `image_urls`, `image_with_roles[].url`, `video_urls` ou `audio_urls`.

## Status e resultados

Consulte a [API de status](https://docs.apimart.ai/pt/api-reference/tasks/status.md). `pending` / `processing` indicam andamento, `completed` sucesso e `failed` falha. Leia `data.result.videos[0].url[0]`; `url` é um array.

```bash theme={null}
curl --request GET \
  --url 'https://api.apimart.ai/v1/tasks/task_example_seedance25flash' \
  --header 'Authorization: Bearer <token>'
```

```json theme={null}
{
  "code": 200,
  "data": {
    "id": "task_example_seedance25flash",
    "status": "completed",
    "progress": 100,
    "cost": 0.3104,
    "credits_cost": 3.104,
    "usage": {
      "completion_tokens": 38800
    },
    "result": {
      "videos": [
        {
          "url": [
            "https://example.com/generated-video.mp4"
          ],
          "last_frame_url": "https://example.com/generated-last-frame.png"
        }
      ]
    }
  }
}
```

| Campo | Significado |
| - | - |
| `data.usage.completion_tokens` | Tokens da liquidação final. Podem estar ausentes por alguns segundos após o término; consulte novamente. |
| `data.cost` | Valor real em USD após descontos da conta. Use o valor retornado. |
| `data.credits_cost` | Créditos efetivamente cobrados. |
| `data.result.videos[].url` | Array de URLs de vídeo; baixe e salve prontamente. |
| `data.result.videos[].last_frame_url` | URL do último quadro, somente após sucesso com `return_last_frame: true`. |
| `data.error.message` | Motivo da falha. Tarefas com falha têm `data.cost: 0` e o valor reservado é devolvido. |

## Cobrança

* O envio reserva um valor pela tarifa por segundo da resolução. Com referência de vídeo, usa o nível com entrada e soma duração de saída e duração total dos vídeos de referência.
* Requisições comuns sem `duration` reservam 5 segundos de saída. `duration: -1`, ou `edit` sem duração, reserva 30 segundos de saída.
* Após o sucesso: `data.usage.completion_tokens` ÷ 1,000,000 × tarifa aplicável por milhão de tokens, com descontos da conta. A diferença é devolvida ou cobrada. A presença de referência de vídeo determina `token` ou `token-input`; o valor final é `data.cost`.
* Envios rejeitados não geram cobrança de geração. Se a geração falhar, a reserva é devolvida. Consulte a [página de preços](https://apimart.ai/pricing).

## Erros comuns

| Situação | Ação |
| - | - |
| HTTP 400: resolução incompatível | Use `480p` / `720p`, não `1080p`. |
| HTTP 400: referências em excesso | Máximo 10 imagens combinadas, 5 vídeos e 5 áudios; verifique também as durações. |
| HTTP 400: rascunho incompatível | Remova `draft` / `draft_task_id`. |
| HTTP 400: tipo, duração ou proporção | Verifique `omni_reference_task_type`, `duration`, `size` / `aspect_ratio`. |
| HTTP 400: `nsfw_content_detected` | Trate como rejeição de moderação; leia `error.message` e altere o conteúdo. |
| Modelo não encontrado | Use `seedance-2-5-flash`, não `seedance-2.5-flash`. |
| Tarefa `failed` | Leia `data.error.message` e ajuste mídias e prompt ao tipo da tarefa. A reserva é devolvida. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.