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

# 图像转视频

### 如何使用 Sunra API 生成视频

Sunra 提供了一个简单易用的 API，允许您使用预训练模型从图像生成视频。此端点非常适合为社交媒体、营销等各种用例从您的图像创建视频片段。

以下是如何使用 Sunra API 生成视频的示例：

<CodeGroup>
  ```javascript Javascript theme={null}
  import { sunra } from "@sunra/client";

  const result = await sunra.subscribe("kling/kling-v2-master/image-to-video", {
    input: {
      prompt: '一只可爱的仓鼠悠闲地躺在救生圈上，戴着时尚的太阳镜，在波光粼粼的海面上随着温柔的波浪漂流。仓鼠舒适地斜躺着，享受着宁静愉快的时光。卡通风格，摄像机跟随主体移动，温馨且画质高。',
      negative_prompt: '',
      guidance_scale: 0.5,
      aspect_ratio: '16:9',
      duration: 5,
      start_image: 'https://assets.sunra.ai/uploads/1748811753168-05ceab0d.png'
    },
    logs: true,
    onQueueUpdate: (update) => {
      console.log(update)
    },
  });
  console.log(result.data);
  console.log(result.requestId);
  ```

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

  result = sunra_client.subscribe(
      "kling/kling-v2-master/image-to-video",
      arguments={
          "prompt": "一只可爱的仓鼠悠闲地躺在救生圈上，戴着时尚的太阳镜，在波光粼粼的海面上随着温柔的波浪漂流。仓鼠舒适地斜躺着，享受着宁静愉快的时光。卡通风格，摄像机跟随主体移动，温馨且画质高。",
          "guidance_scale": 0.5,
          "aspect_ratio": "16:9",
          "duration": 5,
          "start_image": "https://assets.sunra.ai/uploads/1748811753168-05ceab0d.png"
      },
      with_logs=True,
      on_enqueue=print,
      on_queue_update=print,
  )
  print(result)
  ```

  ```java Java theme={null}
  import ai.sunra.client.*;
  import ai.sunra.client.queue.*;
  import java.util.Map;
  import com.google.gson.JsonObject;
  import java.util.function.Consumer;

  ClientConfig config = ClientConfig.builder()
      .withCredentials(CredentialsResolver.fromEnv())
      .build();

  SunraClient client = SunraClient.withConfig(config);
  Map<String, Object> input = Map.of(
      "prompt", "一只可爱的仓鼠悠闲地躺在救生圈上，戴着时尚的太阳镜，在波光粼粼的海面上随着温柔的波浪漂流。仓鼠舒适地斜躺着，享受着宁静愉快的时光。卡通风格，摄像机跟随主体移动，温馨且画质高。",
      "guidance_scale", 0.5,
      "aspect_ratio", "16:9",
      "duration", 5,
      "start_image", "https://assets.sunra.ai/uploads/1748811753168-05ceab0d.png"
  );

  Consumer<QueueStatus.StatusUpdate> statusUpdateHandler = update -> {
      String status = update.getStatus().toString();
      String message = String.format("\nStatus Update: %s, Request ID: %s",
          status, update.getRequestId());
      System.out.println(message);
  };

  SubscribeOptions<JsonObject> options = SubscribeOptions.<JsonObject>builder()
      .input(input)
      .resultType(JsonObject.class)
      .onQueueUpdate(statusUpdateHandler)
      .logs(true)
      .build();

  Output<JsonObject> response = client.subscribe("kling/kling-v2-master/image-to-video", options);
  System.out.println("完成！");
  System.out.println(response.getData());
  ```

  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.sunra.ai/v1/queue/kling/kling-v2-master/image-to-video \
    --header "Authorization: Key $SUNRA_KEY" \
    --header "Content-Type: application/json" \
    --data '{"prompt":"一只可爱的仓鼠悠闲地躺在救生圈上，戴着时尚的太阳镜，在波光粼粼的海面上随着温柔的波浪漂流。仓鼠舒适地斜躺着，享受着宁静愉快的时光。卡通风格，摄像机跟随主体移动，温馨且画质高。","negative_prompt":"","guidance_scale":0.5,"aspect_ratio":"16:9","duration":5,"start_image":"https://assets.sunra.ai/uploads/1748811753168-05ceab0d.png"}'
  ```
</CodeGroup>

### 如何选择要使用的模型

Sunra 提供各种视频生成模型。您可以根据要生成的视频的风格和质量选择最适合您需求的模型。以下是一些可用的模型：

* [kling/kling-v2-master/image-to-video](https://sunra.ai/models/kling/kling-v2-master/image-to-video)：Kling V2 Master 旨在改善提示遵循、运动动态和视觉美学。
* [minimax/i2v-01/image-to-video](https://sunra.ai/models/sunra-ai/minimax-video/image-to-video)：从图像和文本提示生成 6 秒高清视频

要选择模型，只需在 `subscribe` 方法中指定模型 ID，如上面的示例所示。您可以在[图像转视频模型](https://sunra.ai/models?modalities%5B0%5D=modality-image-video)页面找到更多模型及其描述。