bytedance/seedance-2.0-mini/image-to-videoA partir de 19 créditos por um clipe de 5 segundos· Imagem para vídeo

O image-to-video Seedance 2.0 Mini da ByteDance começa o clipe em uma imagem sua e a anima, com som na mesma passada. Os clipes têm 4 a 15 segundos em 480p ou 720p, e uma imagem final opcional faz a tomada terminar em um quadro definido.

Chame com o nome de modelo bytedance/seedance-2.0-mini/image-to-video em POST /jobs/createTask, a partir de 19 créditos por um clipe de 5 segundos (US$ 0,19). Contas novas ganham 30 créditos grátis para você testar primeiro no Playground.

  • Criar vídeo
  • Imagem para vídeo
  • Referências para vídeo
  • Estender vídeo
  • Até 720p
  • Clipes de 4 a 15 s
  • Com som
  • Quadro inicial e final
  • Até 9 imagens de referência
  • 6 proporções
Nome do modelobytedance/seedance-2.0-mini/image-to-video
EndpointPOST https://api.popnow.ai/api/v1/jobs/createTask
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "duration_seconds": 5,
    "generate_audio": true
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

O input é montado a partir do schema abaixo, então passa na validação como está. Troque o prompt e os links pelos seus.

Preço

OpçãoCréditos por segundo≈ USD
resolution 480p3,69US$ 0,037
enable_web_search trueresolution 480p5,4US$ 0,054
resolution 720p7,94US$ 0,079
enable_web_search trueresolution 720p10,8US$ 0,11

1 crédito = US$ 0,01 · Todas as opções e preços: GET /models/bytedance/seedance-2.0-mini/image-to-video

Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 19 créditos por um clipe de 5 segundos (US$ 0,19).

Limites

Duração do clipe
4–15 s
Resoluções
480p · 720p
Proporções
16:9 · 9:16 · 4:3 · 3:4 · 1:1 · 21:9 · adaptive

Parâmetros

Estes campos vêm do mesmo schema que usamos para validar cada requisição. Campos que não estão na lista são rejeitados.

  • image_urlstringObrigatório

    A imagem de partida.

    Faixa
    image/jpeg, image/png, image/webp, image/gif
  • promptstringOpcional

    Describe the intended subject, action, camera, light, sound, and constraints.

    Faixa
    1 – … chars
  • last_image_urlstringOpcional

    Quadro final opcional, para o clipe terminar exatamente onde você quer.

    Faixa
    image/jpeg, image/png, image/webp, image/gif
  • aspect_ratiostringOpcional

    O formato do quadro: horizontal, quadrado ou vertical.

    Padrão
    "adaptive"
    Valores aceitos
    "16:9""9:16""4:3""3:4""1:1""21:9""adaptive"
  • resolutionstringOpcionalMuda o preço

    Tamanho de saída. Maior fica mais nítido e custa mais.

    Padrão
    "720p"
    Valores aceitos
    "480p""720p"
  • duration_secondsintegerOpcionalMuda o preço

    Quanto tempo dura o clipe. Cobrado por segundo.

    Padrão
    5
    Valores aceitos
    -1456789101112131415
  • generate_audiobooleanOpcionalMuda o preço

    Adiciona som combinando com a imagem: vozes, ambiente e efeitos.

    Padrão
    true
  • enable_web_searchbooleanOpcionalMuda o preço

    Consulta a web primeiro para datas, lugares e fatos atuais.

    Padrão
    false
  • seedintegerOpcional

    Repetir o mesmo número dá um resultado reproduzível.

    Faixa
    0 – 2147483647
  • return_last_framebooleanOpcional

    Also return the clip’s final frame as a separate image.

    Padrão
    false
  • bitrate_modestringOpcional

    Encoding bitrate of the delivered file: standard, or high for crisper detail and a larger file.

    Padrão
    "standard"
    Valores aceitos
    "standard""high"
  • watermarkbooleanOpcional

    Add the model’s visible "AI generated" watermark to the video.

    Padrão
    false
JSON Schema bruto
{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "adaptive",
      "description": "Output frame ratio.",
      "enum": [
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "1:1",
        "21:9",
        "adaptive"
      ],
      "type": "string"
    },
    "bitrate_mode": {
      "default": "standard",
      "description": "Encoding bitrate of the delivered file: standard, or high for crisper detail and a larger file.",
      "enum": [
        "standard",
        "high"
      ],
      "type": "string"
    },
    "duration_seconds": {
      "default": 5,
      "description": "Requested output duration in seconds. Pass -1 for smart duration: the model picks the length itself instead of a fixed number.",
      "enum": [
        -1,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "type": "integer"
    },
    "enable_web_search": {
      "default": false,
      "description": "Let the model search the web for information related to the prompt before rendering. Requests with it on are billed at the web-search rate.",
      "type": "boolean"
    },
    "generate_audio": {
      "default": true,
      "description": "Request synchronised output audio.",
      "type": "boolean"
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "A source image that you are authorised to process.",
      "type": "string"
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Optional closing image for the chosen video workflow.",
      "type": "string"
    },
    "prompt": {
      "description": "Describe the intended subject, action, camera, light, sound, and constraints.",
      "minLength": 1,
      "type": "string"
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution.",
      "enum": [
        "480p",
        "720p"
      ],
      "type": "string"
    },
    "return_last_frame": {
      "default": false,
      "description": "Also return the clip’s final frame as a separate image.",
      "type": "boolean"
    },
    "seed": {
      "description": "Random seed. Omit to let the model pick one.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    },
    "watermark": {
      "default": false,
      "description": "Add the model’s visible \"AI generated\" watermark to the video.",
      "type": "boolean"
    }
  },
  "required": [
    "image_url"
  ],
  "type": "object"
}

Um resultado real do Seedance 2.0 Mini

PromptA gloved hand enters from the right and fills the gap in the upper row can by can, facing each label forward, then withdraws. Camera locked off on the shelf. Small metallic clinks, chiller hum, fluorescent light unchanged throughout.
A mesma requisição pela API
{
  "model": "bytedance/seedance-2.0-mini/image-to-video",
  "input": {
    "prompt": "A gloved hand enters from the right and fills the gap in the upper row can by can, facing each label forward, then withdraws. Camera locked off on the shelf. Small metallic clinks, chiller hum, fluorescent light unchanged throughout.",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 4,
    "generate_audio": true
  }
}

Este resultado partiu de um arquivo enviado: coloque o seu link no lugar do link de exemplo.

Respostas, consultas e callbacks

Todos os modelos funcionam do mesmo jeito: crie uma tarefa e depois consulte ou espere o callback.

Veja o preço antes

cURL
curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "duration_seconds": 5,
    "generate_audio": true
  }
}'

Mesmo corpo do createTask. Retorna a cobrança esperada e a máxima possível, sem rodar nada.

Aceita

HTTP
HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 quer dizer que a tarefa foi aceita e os créditos estão reservados, ainda não cobrados. A cobrança final nunca passa da reserva.

Consultar status

cURL
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Consulte a cada poucos segundos, espaçando cada vez mais, e pare quando state for succeeded, failed, canceled ou expired.

Tarefa pronta

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/seedance-2.0-mini/image-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.mp4?signature=FROM_RESPONSE",
          "expiresAt": "2026-10-17T12:20:00Z",
          "mime": "video/mp4",
          "width": 1280,
          "height": 720,
          "durationSeconds": 5
        }
      ]
    },
    "settled": true
  },
  "request_id": "req_example_record"
}

Baixe pela url antes de expiresAt. Precisa de um link novo depois? Peça com POST /common/download-url.

Verificar um callback

Node.js
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.header("X-Webhook-Timestamp");
  const signature = req.header("X-Webhook-Signature") ?? "";
  const body = JSON.parse(req.body.toString("utf8"));
  const taskId = body.data?.taskId ?? body.task_id;
  const digest = createHash("sha256").update(req.body).digest("hex");
  const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
    .update(`${taskId}.${timestamp}.${digest}`)
    .digest("base64");
  const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  // Check the signature first, then reject anything older than five minutes.
  if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
  res.status(200).end(); // answer fast, then fetch the task and store its files
});

Com callBackUrl definida, enviamos a tarefa pronta para você. Confira a assinatura no corpo bruto antes de confiar nela.

Enviar um arquivo local

cURL
curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType": "image/png", "bytes": 482113}'

# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
  -H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.

Links https públicos funcionam como estão. Arquivos locais passam antes por upload-url e commit.