> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Imagem para vídeo

> Anime imagens estáticas em clipes de vídeo com os modelos de imagem para vídeo da Krea, aceitando URLs de imagens hospedadas ou entradas base64 data URI em cada geração.

export const ModelOverviewCard = ({name, description, icon, href}) => {
  const resolvedIcon = (() => {
    if (typeof icon !== "string" || !icon.startsWith("/") || icon.startsWith("//")) return icon;
    if (typeof window === "undefined") return icon;
    const base = "/docs";
    const under = window.location.pathname === base || window.location.pathname.startsWith(base + "/");
    return under && !icon.startsWith(base + "/") ? base + icon : icon;
  })();
  return <a href={href} className="group relative block rounded-xl border border-gray-200 dark:border-gray-800 bg-white dark:bg-black overflow-hidden hover:border-black dark:hover:border-white transition-all duration-200 p-6">
      {}
      <div className="flex items-center justify-center w-8 h-8 rounded-lg mb-4 transition-colors duration-200">
        {icon && <img src={resolvedIcon} alt={`${name} logo`} className="w-8 h-8 object-contain transition-all duration-200" />}
      </div>

      {}
      <div className="space-y-2">
        <h3 className="text-lg font-semibold text-black dark:text-white transition-colors">
          {name}
        </h3>
        <p className="text-sm text-gray-600 dark:text-gray-400 line-clamp-4">
          {description}
        </p>
      </div>

      {}
      <div className="absolute top-6 right-6 opacity-0 group-hover:opacity-100 transition-opacity duration-200">
        <svg className="w-4 h-4 text-black dark:text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
        </svg>
      </div>
    </a>;
};

export const HeroHeader = ({image, video, title, description}) => {
  return <div className="relative aspect-[2/1] h-[30vh] w-full rounded-lg overflow-hidden mb-8">
      {}
      {video && <video autoPlay muted loop playsInline className="absolute top-0 left-0 w-full h-full object-cover hidden md:block m-0" style={{
    zIndex: 1,
    objectPosition: "20% 20%"
  }}>
          <source src={video} type="video/webm" />
        </video>}

      {}
      <img src={image} alt="" className={`absolute top-0 left-0 m-0 w-full h-full object-cover ${video ? "md:hidden" : "block"}`} style={{
    zIndex: 1,
    objectPosition: "20% 20%"
  }} />

      {}
      <div className="absolute inset-0 bg-gradient-to-t from-black/70 via-black/30 to-black/10 flex flex-col justify-end p-8 dark:hidden" style={{
    zIndex: 2
  }}>
        <h1 className="text-4xl font-bold text-white m-0 drop-shadow-[0_2px_4px_rgba(0,0,0,0.5)]">
          {title}
        </h1>
        <p className="text-lg text-white/95 mt-2 drop-shadow-[0_1px_2px_rgba(0,0,0,0.5)]">
          {description}
        </p>
      </div>

      {}
      <div className="absolute inset-0 bg-gradient-to-t from-black/80 via-black/40 to-black/20 hidden dark:flex flex-col justify-end p-8" style={{
    zIndex: 2
  }}>
        <h1 className="text-4xl font-bold text-white m-0 drop-shadow-[0_2px_4px_rgba(0,0,0,0.5)]">
          {title}
        </h1>
        <p className="text-lg text-white/95 mt-2 drop-shadow-[0_1px_2px_rgba(0,0,0,0.5)]">
          {description}
        </p>
      </div>
    </div>;
};

<HeroHeader image="https://s.krea.ai/docs-image-to-video.webp" video="https://s.krea.ai/docs-image-to-video-new.webm" title="Imagem para vídeo" description="Dê vida às suas imagens. Transforme imagens estáticas em vídeos dinâmicos com animação e movimentação de câmera baseadas em IA." />

## Modelos populares

<div className="grid grid-cols-1 md:grid-cols-2 gap-4 hidden dark:grid">
  <ModelOverviewCard name="Veo 3.1" href="/api-reference/video/veo-31" icon="/images/logo/deepmind-dark.svg" description="O modelo de vídeo do Google, com aderência excepcional ao prompt e qualidade cinematográfica." />

  <ModelOverviewCard name="Kling 2.5" href="/api-reference/video/kling-25" icon="/images/logo/kling-dark.svg" description="Controle de movimento avançado com consistência temporal e física realista." />

  <ModelOverviewCard name="Hailuo 2.3" href="/api-reference/video/hailuo-23" icon="/images/logo/hailuo-dark.svg" description="Geração rápida com movimento suave e transições de cena naturais." />

  <ModelOverviewCard name="Wan 2.5" href="/api-reference/video/wan-25" icon="/images/logo/qwen-dark.svg" description="Síntese de vídeo em alta resolução com controle de estilo e preservação de detalhes." />
</div>

<div className="grid grid-cols-1 md:grid-cols-2 gap-4 block dark:hidden">
  <ModelOverviewCard name="Veo 3.1" href="/api-reference/video/veo-31" icon="/images/logo/deepmind-light.svg" description="O modelo de vídeo do Google, com aderência excepcional ao prompt e qualidade cinematográfica." />

  <ModelOverviewCard name="Kling 2.5" href="/api-reference/video/kling-25" icon="/images/logo/kling-light.svg" description="Controle de movimento avançado com consistência temporal e física realista." />

  <ModelOverviewCard name="Hailuo 2.3" href="/api-reference/video/hailuo-23" icon="/images/logo/hailuo-light.svg" description="Geração rápida com movimento suave e transições de cena naturais." />

  <ModelOverviewCard name="Wan 2.5" href="/api-reference/video/wan-25" icon="/images/logo/qwen-light.svg" description="Síntese de vídeo em alta resolução com controle de estilo e preservação de detalhes." />
</div>

***

<Note>
  A geração de imagem para vídeo combina a sua imagem de entrada com geração de movimento. O resultado mantém consistência visual com a imagem de origem enquanto adiciona movimento realista.
</Note>

***

## Etapa 1: prepare sua imagem

Primeiro, você precisa fornecer a imagem de origem. Você pode enviar um arquivo, referenciar uma URL ou fornecer um data URI em base64.

<CodeGroup>
  ```javascript Node.js theme={null}
  // npm install @krea-ai/sdk
  import { openAsBlob } from "node:fs";
  import { Krea } from "@krea-ai/sdk";

  const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

  // Option 1: Upload a local file and use the hosted asset URL
  const file = await openAsBlob("./input-image.jpg", { type: "image/jpeg" });
  const asset = await krea.assets.upload(file, {
    description: "Input image",
  });
  const imageUrl = asset.image_url;

  // Option 2: Using image URL
  // const imageUrl = "https://example.com/input-image.jpg";
  ```

  ```python Python theme={null}
  import requests

  API_BASE = "https://api.krea.ai"
  API_TOKEN = "YOUR_API_TOKEN"

  # Option 1: Upload a local file and use the hosted asset URL
  with open("input-image.jpg", "rb") as image_file:
      upload = requests.post(
          f"{API_BASE}/assets",
          headers={"Authorization": f"Bearer {API_TOKEN}"},
          files={"file": ("input-image.jpg", image_file, "image/jpeg")},
          data={"description": "Input image"},
      )
  upload.raise_for_status()
  image_url = upload.json()["image_url"]

  # Option 2: Using image URL
  # image_url = "https://example.com/input-image.jpg"
  ```

  <Info>
    **Substitua pelo seu token de API**

    Para substituir o placeholder YOUR\_API\_TOKEN nos exemplos acima, você precisará gerar um token de API em [krea.ai/settings/api-tokens](https://www.krea.ai/settings/api-tokens). Siga as instruções da página [Chaves de API e cobrança](/developers/api-keys-and-billing) caso precise de ajuda.
  </Info>
</CodeGroup>

***

## Etapa 2: gere o vídeo

Faça uma requisição POST para `/generate/video/kling/kling-2.5` com sua imagem e parâmetros de movimento.

<CodeGroup>
  ```javascript Node.js theme={null}
  // npm install @krea-ai/sdk
  import { Krea } from "@krea-ai/sdk";

  const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

  const job = await krea.video("kling/kling-2.5", {
    start_image: imageUrl,
    prompt: "gentle camera pan from left to right, subtle depth",
    duration: 5,
    aspect_ratio: "16:9"
  });

  console.log(`Job ID: ${job.job_id}`);
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.krea.ai/generate/video/kling/kling-2.5 \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "start_image": "https://example.com/input-image.jpg",
      "prompt": "gentle camera pan from left to right, subtle depth",
      "duration": 5,
      "aspect_ratio": "16:9"
    }'
  ```

  ```python Python theme={null}
  response = requests.post(
      f"{API_BASE}/generate/video/kling/kling-2.5",
      headers={
          "Authorization": f"Bearer {API_TOKEN}",
          "Content-Type": "application/json"
      },
      json={
          "start_image": image_url,
          "prompt": "gentle camera pan from left to right, subtle depth",
          "duration": 5,
          "aspect_ratio": "16:9"
      }
  )

  job = response.json()
  print(f"Job ID: {job['job_id']}")
  ```

  ```go Go theme={null}
  package main

  import (
      "bytes"
      "encoding/json"
      "fmt"
      "net/http"
  )

  func main() {
      apiBase := "https://api.krea.ai"
      apiToken := "YOUR_API_TOKEN"

      payload := map[string]interface{}{
          "start_image": "https://example.com/input-image.jpg",
          "prompt": "gentle camera pan from left to right, subtle depth",
          "duration": 5,
          "aspect_ratio": "16:9",
      }

      jsonData, _ := json.Marshal(payload)
      req, _ := http.NewRequest("POST", apiBase+"/generate/video/kling/kling-2.5", bytes.NewBuffer(jsonData))
      req.Header.Set("Authorization", "Bearer "+apiToken)
      req.Header.Set("Content-Type", "application/json")

      client := &http.Client{}
      resp, _ := client.Do(req)
      defer resp.Body.Close()

      var job map[string]interface{}
      json.NewDecoder(resp.Body).Decode(&job)
      fmt.Printf("Job ID: %s\n", job["job_id"])
  }
  ```
</CodeGroup>

<Info>
  **Substitua pelo seu token de API**

  Para substituir o placeholder YOUR\_API\_TOKEN nos exemplos acima, você precisará gerar um token de API em [krea.ai/settings/api-tokens](https://www.krea.ai/settings/api-tokens). Siga as instruções da página [Chaves de API e cobrança](/developers/api-keys-and-billing) caso precise de ajuda.
</Info>

**Exemplo de resposta**

```json theme={null}
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_time": "60-120 seconds"
}
```

***

## Etapa 3: faça polling pelos resultados

Faça polling em `/jobs/{job_id}` a cada 5 segundos para acompanhar o progresso da geração do vídeo.

<CodeGroup>
  ```javascript Node.js theme={null}
  // npm install @krea-ai/sdk
  import { Krea } from "@krea-ai/sdk";

  const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

  async function waitForVideo(jobId) {
    const completed = await krea.jobs.wait(jobId, { intervalMs: 5000 });
    return completed.result.urls[0];
  }

  const videoUrl = await waitForVideo(job.job_id);
  console.log(`Video ready: ${videoUrl}`);
  ```

  ```bash cURL theme={null}
  curl -X GET https://api.krea.ai/jobs/YOUR_JOB_ID \
    -H "Authorization: Bearer YOUR_API_TOKEN"
  ```

  ```python Python theme={null}
  import time

  def wait_for_video(job_id):
      while True:
          response = requests.get(
              f"{API_BASE}/jobs/{job_id}",
              headers={"Authorization": f"Bearer {API_TOKEN}"}
          )
          job = response.json()

          if job["status"] == "completed":
              return job["result"]["urls"][0]
          if job["status"] in ("failed", "cancelled"):
              raise Exception(f"Job failed: {job['status']}")

          # Show progress if available
          if "progress" in job:
              print(f"Progress: {job['progress']}%")
          else:
              print(f"Status: {job['status']}")

          time.sleep(5)

  video_url = wait_for_video(job["job_id"])
  print(f"Video ready: {video_url}")
  ```

  ```go Go theme={null}
  func waitForVideo(jobID string) (string, error) {
      for {
          req, _ := http.NewRequest("GET", apiBase+"/jobs/"+jobID, nil)
          req.Header.Set("Authorization", "Bearer "+apiToken)

          resp, _ := client.Do(req)
          var job map[string]interface{}
          json.NewDecoder(resp.Body).Decode(&job)
          resp.Body.Close()

          switch job["status"] {
          case "completed":
              result := job["result"].(map[string]interface{})
              urls := result["urls"].([]interface{})
              return urls[0].(string), nil
          case "failed", "cancelled":
              return "", fmt.Errorf("job failed: %s", job["status"])
          }

          // Show progress if available
          if progress, ok := job["progress"]; ok {
              fmt.Printf("Progress: %.0f%%\n", progress)
          } else {
              fmt.Printf("Status: %s\n", job["status"])
          }

          time.Sleep(5 * time.Second)
      }
  }
  ```
</CodeGroup>

**Exemplo de resposta concluída**

```json theme={null}
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2025-01-15T10:30:00.000Z",
  "completed_at": "2025-01-15T10:31:45.000Z",
  "result": {
    "urls": ["https://gen.krea.ai/videos/your-video.mp4"]
  }
}
```

<Note>
  **Webhooks disponíveis!**

  Configure webhooks para receber notificações quando os jobs forem concluídos. Veja o [guia de Webhooks](/developers/webhooks) para começar.
</Note>

***

## Parâmetros comuns

<Tip>
  Para uma lista de parâmetros detalhados de todos os modelos, veja a página [APIs de modelos](/api-reference/introduction).
</Tip>

| Parâmetro      | Tipo   | Descrição                                                            |
| -------------- | ------ | -------------------------------------------------------------------- |
| `start_image`  | string | URL da imagem de origem                                              |
| `prompt`       | string | Descrição do movimento e da movimentação de câmera desejados         |
| `duration`     | number | Duração do vídeo em segundos. Os valores aceitos dependem do modelo. |
| `aspect_ratio` | string | Proporção do vídeo, como `16:9`, `9:16` ou `1:1`                     |
| `end_image`    | string | URL opcional do frame final para modelos compatíveis                 |
| `mode`         | string | Modo de qualidade opcional para modelos que oferecem essa opção      |

<Tip>
  **Dicas para prompts de movimento:**

  * Descreva a movimentação de câmera (pan, zoom, dolly, tilt)
  * Especifique a direção e a velocidade do movimento
  * Mencione efeitos de profundidade e parallax
  * Use uma linguagem de câmera contida para animações sutis
  * Use verbos de ação mais fortes para efeitos dramáticos
</Tip>