apimart-zoe API

O apimart-zoe é um modelo multimodal de geração de vídeo da APIMart, chamado com o ID de modelo apimart-zoe. A apimart-zoe API oferece texto para vídeo, vídeo a partir do primeiro e do último quadro, vídeo a partir de referências de imagem, vídeo e áudio, edição de um vídeo existente, áudio opcional gerado junto com o vídeo e um fluxo de duas etapas do rascunho 480p ao final 1080p. Os clipes têm 4–30 segundos em 480p, 720p, 1080p, 2k ou 4k.

Envie POST /v1/videos/generations com model apimart-zoe e o seu prompt, usando Authorization: Bearer <API key>. A resposta retorna um task_id. A geração costuma levar 1–3 minutos: consulte GET /v1/tasks/{task_id} a cada 5–10 segundos até data.status ser completed e leia a URL do vídeo em data.result.videos[0].url[0]. O exemplo desta página tem código cURL e Python, e a referência completa da apimart-zoe API está na documentação da APIMart.

model (apimart-zoe) é obrigatório. prompt é obrigatório em texto para vídeo, opcional quando você envia apenas mídias, e aceita até 204.800 caracteres. Os parâmetros opcionais são resolution (480p, 720p, 1080p, 2k ou 4k), aspect_ratio ou size (21:9, 16:9, 4:3, 1:1, 3:4, 9:16 ou adaptive), duration ou seconds (4–30 ou -1), audio ou generate_audio, seed, image_with_roles, image_urls (aliases image, images, image_url), first_frame_image, last_frame_image, video_urls, audio_urls, draft, draft_task_id, omni_reference_task_type (auto, reference ou edit), return_last_frame, output_format ou response_format (mp4 ou mov) e enhance_prompt, além do campo da APIMart nsfw_check. negative_prompt, camera_fixed (inclusive camerafixed), extend_from_task_id, mask_url, video_list, element_list, multi_shot e tools não são suportados: se o campo aparecer na requisição, mesmo vazio, false ou null, retorna 400. n só pode ser omitido ou igual a 1. A tabela de parâmetros desta página mostra padrões e limites.

Defina duration (ou seconds) com um número inteiro de 4 a 30; o padrão é 5, e -1 deixa o modelo decidir. resolution é 480p, 720p (padrão), 1080p, 2k ou 4k, sem diferenciar maiúsculas de minúsculas. aspect_ratio, também aceito como size, é 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 ou adaptive (padrão: o modelo ou suas mídias definem o enquadramento). Na edição de vídeo, omita duration e aspect_ratio (ou envie -1 e adaptive): a duração e o enquadramento seguem o vídeo de origem. Rascunhos são sempre 480p e vídeos finais, 1080p.

Sim. Envie image_with_roles com first_frame e last_frame, ou use first_frame_image e last_frame_image. Cada quadro aceita uma imagem, e o último quadro exige o primeiro. Uma requisição com primeiro e último quadro não pode incluir também imagens, vídeos ou áudio de referência; se incluir, retorna 400 e não é cobrada. Use o prompt para descrever como a cena passa de um quadro para o outro.

Até 30 imagens, 10 vídeos e 10 clipes de áudio de referência, 50 arquivos no total; o áudio de referência precisa vir com uma imagem ou um vídeo de referência. Imagens: jpeg, png, webp, bmp, tiff, gif, heic ou heif, 300–6000 pixels por lado, proporção 0,4–2,5 e menos de 30 MB. Vídeos: mp4 ou mov (H.264/H.265, faixa de áudio AAC ou MP3), 2–15 segundos cada (1,8–15,2 s são aceitos) e até 200 MB, largura e altura de 300–6000 pixels, largura × altura entre 409.600 e 8.295.044 (de cerca de 640×640 a 3840×2160), proporção 0,4–2,5 e 24–60 fps após arredondamento (23,976 e 59,94 são aceitos); o vídeo de origem de uma edição pode ter 4–30 segundos (no mínimo 3,8 s e menos de 30,2 s), e sem tipo de tarefa, vídeos com mais de 15 segundos exigem edit. Áudio: wav ou mp3, 2–15 segundos (1,8–15,2 s) e até 15 MB por clipe, 30 segundos no total (até 30,2 s). Duração, dimensões, proporção e fps dos vídeos de referência e a duração do áudio de referência são verificados no envio: fora da especificação, retorna 400 invalid_request_error, sem cobrança. Dimensões das imagens, tamanho de arquivo e codificação são verificados durante a geração: fora da especificação, a tarefa falha e o valor é devolvido automaticamente, então confira seus arquivos antes de chamar. Todas as mídias devem ser URLs públicas http(s) ou IDs asset://; URIs data: não são aceitas, então envie antes os arquivos para um endereço público. No envio, a APIMart registra cada arquivo automaticamente, e o mesmo arquivo reutilizado em até 7 dias não é registrado de novo. Se você enviar apenas mídias, prompt pode ser omitido.

Envie uma requisição com draft: true para obter uma prévia barata em 480p; rascunhos só podem ser 480p e não podem ser combinados com edição de vídeo. Quando o rascunho terminar com sucesso, envie uma segunda requisição com model e draft_task_id igual ao task_id do rascunho. O final é gerado em 1080p e reaproveita o prompt, as mídias, a duração, a proporção, a semente e a configuração de áudio do rascunho. Além de model, draft_task_id, resolution e campos comuns como nsfw_check ou webhook, nenhum campo é aceito: prompt, mídias, duration, aspect_ratio, seed, audio, omni_reference_task_type, return_last_frame, output_format ou enhance_prompt retornam 400, mesmo vazios. Gere o final em até 24 horas: um draft_task_id inexistente, que não seja rascunho, não concluído ou com mais de 24 horas retorna 400. O rascunho e o final são cobrados, cada um, como uma geração; o final é cobrado em 1080p com a duração do rascunho, ou com a duração real dele se o rascunho usou -1.

Erros de envio retornam um objeto error com message, type, param e code, e não são cobrados. 400 invalid_request_error cobre valores inválidos, quantidade e combinação de mídias (como primeiro e último quadro junto com referências, ou image_urls junto com image_with_roles), duração, dimensões, proporção ou fps de vídeos de referência e duração de áudio de referência fora dos limites, as regras de tipo de tarefa e de edição de vídeo, valores de output_format, as regras de rascunho e final e parâmetros não suportados, como negative_prompt ou camera_fixed. 400 input_video_probe_failed indica que um vídeo de referência não está acessível ou que a duração não pôde ser lida. 402 payment_required indica saldo insuficiente; com duration -1 ou na edição de vídeo, 30 segundos são reservados. 400 nsfw_content_detected indica que o nsfw_check detectou conteúdo; message traz as categorias detectadas. 503 draft_channel_unavailable ou draft_task_unavailable indica que os rascunhos estão temporariamente indisponíveis: tente de novo mais tarde ou gere um novo rascunho.

Um clipe costuma levar 1–3 minutos, então consulte a cada 5–10 segundos. data.status é pending, processing, completed ou failed, e data.progress vai de 0 a 100. A URL do vídeo em data.result.videos[0].url está armazenada na APIMart e expira 72 horas após a conclusão, então baixe o vídeo a tempo. Com return_last_frame: true, data.result.last_frame_url também traz o último quadro como imagem png. Se a tarefa falhar, inclusive quando o registro das mídias não é aprovado ou a verificação de dimensões de imagem, tamanho de arquivo ou codificação falha durante a geração, data.error.message informa o motivo, data.error.code é task_failed e data.cost é 0, porque o valor reservado é devolvido automaticamente.

A apimart-zoe API cobra por segundo gerado, com tarifas para 480p, 720p, 1080p, 2k e 4k e uma tarifa separada para requisições com vídeo de referência. Se você definir duration (4–30) ou deixar o padrão de 5, são cobrados os segundos solicitados, sem ajuste posterior à duração do clipe. Com duration -1 ou na edição de vídeo (omni_reference_task_type: edit), 30 segundos são pré-cobrados e, ao final, ajustados à duração real do clipe arredondada ao segundo mais próximo; a edição de vídeo usa a tarifa de requisições com vídeo de referência. Com vídeo de referência, segundos cobrados = duração do vídeo + max(duração total dos vídeos de referência, ⌈duração do vídeo × 2/3⌉); a duração de referência é medida no envio, vídeo a vídeo, somada, arredondada para baixo ao segundo e não é ajustada depois. Um final gerado a partir de um rascunho é cobrado em 1080p com a duração do rascunho (a duração real do rascunho, se ele usou -1) e, se o rascunho usou vídeo de referência, também soma a duração dele. O valor cobrado reflete o desconto do seu nível de membro ou grupo de conta; veja a tabela de preços em tempo real desta página.

Na APIMart, os dois modelos usam POST /v1/videos/generations e GET /v1/tasks/{task_id}, criam clipes de 4–30 segundos em proporções de 21:9 a 9:16, aceitam até 30 imagens, 10 vídeos e 10 clipes de áudio de referência por requisição, oferecem seed, geração de áudio, return_last_frame, output_format e edição de vídeo (omni_reference_task_type: edit) e têm o fluxo de rascunho 480p para final 1080p. As diferenças: o apimart-zoe (ID de modelo apimart-zoe) também gera 2k e 4k, não permite combinar primeiro e último quadro com referências, exige uma imagem ou um vídeo de referência quando você envia áudio de referência e deixa o modelo decidir sobre o áudio quando audio é omitido; no Seedance 2.5 (seedance-2.5), generate_audio vem ativado por padrão e também há extensão de vídeo (extend), que no apimart-zoe ainda não foi liberada. Com vídeo de referência, os dois modelos também contam os segundos cobrados de forma diferente. As tabelas de comparação desta página mostram cada diferença e os preços atuais por segundo.

Depende da resolução e de você enviar ou não um vídeo de referência. A comparação de preços desta página mostra as tarifas atuais por segundo dos dois modelos com e sem vídeo de referência, a diferença em porcentagem e exemplos de custo para durações comuns. Com vídeo de referência, o apimart-zoe soma max(segundos totais de referência arredondados para baixo, ⌈segundos gerados × 2/3⌉) aos segundos gerados, enquanto o Seedance 2.5 soma os segundos do vídeo de referência; compare o exemplo que corresponde ao seu clipe. O apimart-zoe também tem faixas 2k e 4k que o Seedance 2.5 não oferece. As tarifas vêm da API de preços da APIMart e dependem do seu nível de membro.

Não. É uma API paga por uso, cobrada por segundo gerado, e um rascunho e o seu final são cobrados, cada um, como uma geração. Erros de envio não são cobrados, a requisição retorna 402 se o saldo for insuficiente, e tarefas com falha são reembolsadas automaticamente, com data.cost igual a 0. O seu preço depende do nível de membro ou grupo de conta; a tabela de preços em tempo real desta página mostra a tarifa atual de cada resolução.

Cadastre-se na APIMart, abra a página API Keys no painel e crie uma key; depois envie-a como Authorization: Bearer <key>. A mesma key chama a apimart-zoe API e os outros modelos da APIMart, com pagamento por uso e sem assinatura.