doubao-seedance-1-5-pro — Geração de vídeo

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

POST

videos

generations

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Autorização

Authorization

string

obrigatório

Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua API Key:Acesse a página de gerenciamento de API Keys para obter sua API KeyAdicione-a ao cabeçalho da requisição:

Authorization: Bearer YOUR_API_KEY

Parâmetros da requisição

model

string

obrigatório

Nome do modelo de geração de vídeoModelos suportados:

doubao-seedance-1-5-pro — versão 1.5 Pro, suporta geração de áudio e primeiro/último frame

prompt

string

obrigatório

Descrição do conteúdo do vídeoDescreva cenas, ações e estilos em detalhes para obter melhores resultados de geraçãoExemplo: "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"

duration

integer

padrão:"5"

Duração do vídeo (segundos)Faixa suportada: 4 a 12 segundosPadrão: 5

aspect_ratio

string

padrão:"16:9"

Proporção do vídeoOpções:

16:9 — paisagem
9:16 — retrato
1:1 — quadrado
4:3 — proporção tradicional
3:4 — proporção tradicional vertical
21:9 — ultrawide

Padrão: 16:9

resolution

string

padrão:"720p"

Resolução do vídeoOpções:

480p — definição padrão
720p — alta definição
1080p — Full HD

Padrão: 720p

seed

integer

Inteiro de seed para controlar a aleatoriedade do conteúdo geradoFaixa de valores: inteiro entre -1 e 2^32-1

Para a mesma requisição, se o modelo receber valores de seed diferentes (por exemplo, não especificar o seed ou defini-lo como -1, que usará um número aleatório), serão gerados resultados diferentes
Para a mesma requisição, se o modelo receber o mesmo valor de seed, serão gerados resultados semelhantes, mas não há garantia de que sejam idênticos

audio

boolean

padrão:"false"

Se deve gerar áudioQuando definido como true, o vídeo incluirá áudio gerado por IA acompanhando-oPadrão: false

A geração de áudio é exclusiva da 1.5 Pro; a versão 1.0 não suporta este parâmetro

camerafixed

boolean

padrão:"false"

Se deve fixar a câmeraQuando definido como true, a posição da câmera permanece fixaPadrão: false

Combinações de resolução e proporção

Resolução	Proporções suportadas	Observações
480p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Todas suportadas
720p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Todas suportadas
1080p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Todas suportadas

image_urls

array<url>

Array de URLs de imagem para geração imagem-para-vídeoRegras de atribuição automática de papel:

1 imagem = primeiro frame
2 imagens = primeiro frame + último frame

Exemplo: ["https://example.com/first.png", "https://example.com/last.png"]

image_urls e image_with_roles não podem ser usados em conjunto

image_with_roles

array

Array de imagens com papéis para um controle mais preciso

Mostrar Descrição dos campos

url

string

obrigatório

URL da imagem

role

string

obrigatório

Papel da imagemOpções:

first_frame — imagem do primeiro frame, usada como frame inicial do vídeo (apenas uma suportada)
last_frame — imagem do último frame, usada como frame final do vídeo (apenas uma suportada)

Exemplo:

[
  {"url": "https://example.com/start.png", "role": "first_frame"},
  {"url": "https://example.com/end.png", "role": "last_frame"}
]

image_urls e image_with_roles não podem ser usados em conjunto
Apenas uma imagem de primeiro frame e uma de último frame são suportadas

Resposta

code

integer

Código de status da resposta, 200 em caso de sucesso

data

array

Array de dados da resposta

Mostrar Elementos do array

status

string

Status da tarefa, submitted no envio inicial

task_id

string

Identificador único da tarefa para consultar status e resultados

Casos de uso

Caso 1: Texto-para-vídeo com áudio

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand",
  "audio": true
}

Caso 2: Vídeo curto vertical de alta qualidade

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "A girl spinning under cherry blossom trees, petals falling with the wind",
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "audio": true
}

Caso 3: Vídeo dinâmico a partir do primeiro frame

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Animate the image with natural dynamic effects",
  "image_urls": ["https://example.com/first.png"],
  "duration": 5,
  "audio": true
}

Caso 4: Efeito de transição com primeiro/último frame

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Scene transitions from day to night, city lights gradually turning on",
  "image_with_roles": [
    {"url": "https://example.com/day.png", "role": "first_frame"},
    {"url": "https://example.com/night.png", "role": "last_frame"}
  ],
  "duration": 5
}

Consultar resultados da tarefaA geração de vídeo é uma tarefa assíncrona que retorna um task_id ao ser enviada. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.

Diferenças em relação à versão 1.0

Recurso	1.0 fast/quality	1.5 Pro
Resolução padrão	1080p	720p
Resoluções suportadas	480p/720p/1080p	480p/720p/1080p
Faixa de duração	2-12s	4-12s
Geração de áudio	Não suportado	Suportado
Imagem de referência	`reference` (1 imagem)	Não suportado

doubao-seedance-1-0-pro — Geração de vídeo doubao-seedance-2.0 — Geração de vídeo

Documentation Index

​Autorização

​Parâmetros da requisição

​Combinações de resolução e proporção

​Resposta

​Casos de uso

​Caso 1: Texto-para-vídeo com áudio

​Caso 2: Vídeo curto vertical de alta qualidade

​Caso 3: Vídeo dinâmico a partir do primeiro frame

​Caso 4: Efeito de transição com primeiro/último frame

​Diferenças em relação à versão 1.0

Autorização

Parâmetros da requisição

Combinações de resolução e proporção

Resposta

Casos de uso

Caso 1: Texto-para-vídeo com áudio

Caso 2: Vídeo curto vertical de alta qualidade

Caso 3: Vídeo dinâmico a partir do primeiro frame

Caso 4: Efeito de transição com primeiro/último frame

Diferenças em relação à versão 1.0