Referência da API

O que é a API

A API do MyDreamVid permite que o seu próprio software gere vídeos e imagens com os modelos Seedance e Seedream, sem ninguém clicando pelo estúdio. Seu programa envia um prompt (e arquivos de referência opcionais), executamos as mesmas verificações de segurança e os mesmos preços do estúdio web, e seu programa coleta o arquivo pronto. Os créditos saem do mesmo saldo da conta.

Para quem é

• Equipes que geram em volume: catálogos de produtos, variações de anúncios, clipes para redes sociais, versões localizadas de um mesmo vídeo.
• Desenvolvedores adicionando geração de vídeo ou imagem ao próprio app, ferramenta, bot ou pipeline interno.
• Agências e estúdios que querem o próprio front-end enquanto cuidamos dos modelos, das filas e da cobrança.

Se você faz alguns vídeos por semana manualmente, você não precisa da API. O estúdio faz tudo o que a API faz, pelos mesmos preços.

Autenticação

Toda requisição leva uma chave bearer. As chaves são criadas no estúdio e mostradas uma única vez.

• Header: Authorization: Bearer mdv_live_…
• A permissão write pode criar e cancelar tarefas e enviar arquivos; read só pode listar e consultar.
• As chaves ficam disponíveis após uma recarga Creator (US$ 25) ou Studio (US$ 50). Créditos nunca expiram.
• A API deve ser chamada do seu servidor. Não coloque chaves em código de navegador ou de aplicativo móvel.

Saiba o preço antes

Toda tarefa custa créditos (1 crédito = US$ 0,01). Peça um orçamento antes de criar: é grátis, não precisa de Idempotency-Key e retorna exatamente o que a tarefa vai reservar. O mesmo número volta como credits_reserved quando você cria a tarefa, e credits_charged na tarefa concluída é o que você realmente pagou (qualquer parte não usada da reserva é devolvida).

GET /v1/credits mostra seu saldo disponível e reservado a qualquer momento. Tarefas criadas pela API também aparecem no estúdio em Minhas Criações e no histórico de Créditos.

Endpoints

• GET /v1/models — Modelos com durações, resoluções, proporções, preços em créditos por segundo e limites de referência.
• POST /v1/videos/quote — Custo exato em créditos de uma tarefa. Grátis, sem reserva.
• POST /v1/videos — Cria uma tarefa. Body: kind (t2v | i2v | r2v), model, prompt, duration_s, resolution, ratio, generate_audio opcional, references. Requer Idempotency-Key.
• GET /v1/videos/{id} — Status da tarefa; uma tarefa concluída traz video_url.
• GET /v1/videos — Suas tarefas, das mais novas para as mais antigas, paginadas por cursor (limit, cursor).
• POST /v1/videos/{id}/cancel — Cancela uma tarefa em waiting ou queued.
• POST /v1/files/presign — Vaga de upload para um arquivo de referência de imagem, vídeo ou áudio.
• POST /v1/files/{media_id}/confirm — Conclui um upload: o arquivo é analisado e passa pela verificação de segurança, e então pode ser usado como referência.
• GET /v1/credits — Créditos disponíveis e reservados.

Limites

• 60 requisições por minuto por chave.
• 2 tarefas em andamento (waiting, queued ou running) por conta através da API.
• As filas por modelo são compartilhadas por todos; quando uma fila está cheia, sua tarefa espera na ordem e é enviada automaticamente.
• Até 5 chaves ativas por conta.
• Arquivos: imagens até 10 MB, vídeo até 50 MB, áudio até 20 MB. Vídeos de referência precisam ter pelo menos 2 segundos; vídeo e áudio podem ter no máximo 5 minutos.