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
}'
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())
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());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
seedance-2-5-flash
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.
POST
/
v1
/
videos
/
generations
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
}'
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())
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());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
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
}'
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())
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());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
POST /v1/videos/generations, leia data[0].task_id e consulte GET /v1/tasks/{task_id}.
Parâmetros da requisição
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.Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.
true: verificar prompts e imagens de entrada comomni-moderation-latestfalseou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
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 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.Somente
480p / 720p; padrão 720p. Valores como 1080p, 2k ou 4k retornam HTTP 400 no envio.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.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.Gerar som, padrão
true. Alias: audio. Controla a saída, separadamente do áudio de referência audio_urls.auto (padrão), reference, edit ou extend, apenas para tarefas com referências. Tipos explícitos ativam as verificações no envio descritas abaixo.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.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.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.
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.
Com
true, retorna uma imagem do último quadro após o sucesso em data.result.videos[].last_frame_url.draft / draft_task_id não são compatíveis; remova-os ou o envio retornará HTTP 400. Para rascunhos, use Seedance 2.5.Requisitos de mídia
Use URLshttp(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. |
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
{
"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
{
"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
{
"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
{
"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 useasset://. No upload, model também deve ser seedance-2-5-flash. Consulte a API de recursos e use o nome Flash abaixo.
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"
}
]
}'
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.pending / processing indicam andamento, completed sucesso e failed falha. Leia data.result.videos[0].url[0]; url é um array.
curl --request GET \
--url 'https://api.apimart.ai/v1/tasks/task_example_seedance25flash' \
--header 'Authorization: Bearer <token>'
{
"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
durationreservam 5 segundos de saída.duration: -1, oueditsem 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 determinatokenoutoken-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.
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. |