> ## 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 alojadas 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 movimento de câmara potenciados por 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="Modelo de vídeo da Google, com aderência excecional ao prompt e qualidade cinematográfica." />

  <ModelOverviewCard name="Kling 2.5" href="/api-reference/video/kling-25" icon="/images/logo/kling-dark.svg" description="Controlo avançado de movimento 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 controlo de estilo e preservação de detalhe." />
</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="Modelo de vídeo da Google, com aderência excecional ao prompt e qualidade cinematográfica." />

  <ModelOverviewCard name="Kling 2.5" href="/api-reference/video/kling-25" icon="/images/logo/kling-light.svg" description="Controlo avançado de movimento 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 controlo de estilo e preservação de detalhe." />
</div>

***

<Note>
  A geração 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, ao mesmo tempo que adiciona movimento realista.
</Note>

***

## Passo 1: Preparar a sua imagem

Primeiro, tem de fornecer a imagem de origem. Pode carregar um ficheiro, referenciar um 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 marcador de posição YOUR\_API\_TOKEN nos exemplos acima, terá de 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 Faturação](/developers/api-keys-and-billing) caso precise de ajuda.
  </Info>
</CodeGroup>

***

## Passo 2: Gerar o vídeo

Faça um pedido POST para `/generate/video/kling/kling-2.5` com a sua imagem e os 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 marcador de posição YOUR\_API\_TOKEN nos exemplos acima, terá de 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 Faturação](/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"
}
```

***

## Passo 3: Consultar os resultados

Consulte `/jobs/{job_id}` a cada 5 segundos para verificar 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 as tarefas terminarem. Consulte o [guia de Webhooks](/developers/webhooks) para começar.
</Note>

***

## Parâmetros comuns

<Tip>
  Para uma lista detalhada dos parâmetros de todos os modelos, consulte 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 pretendido e do movimento de câmara              |
| `duration`     | number | Duração do vídeo em segundos. Os valores suportados dependem do modelo. |
| `aspect_ratio` | string | Rácio de aspeto do vídeo, como `16:9`, `9:16` ou `1:1`                  |
| `end_image`    | string | URL opcional do fotograma final, para modelos que o suportem            |
| `mode`         | string | Modo de qualidade opcional, para modelos que disponibilizem essa opção  |

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

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