> ## 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/text-to-video", {
    input: {
      prompt: '一隻北極熊在雪地裡拉小提琴。',
      guidance_scale: 0.5,
      aspect_ratio: '16:9',
      duration: 5
    },
    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/text-to-video",
      arguments={
          "prompt": "一隻北極熊在雪地裡拉小提琴。",
          "guidance_scale": 0.5,
          "aspect_ratio": "16:9",
          "duration": 5
      },
      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
  );

  Consumer<QueueStatus.StatusUpdate> statusUpdateHandler = update -> {
      String status = update.getStatus().toString();
      String message = String.format("\n狀態更新：%s，請求 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/text-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/text-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}'
  ```
</CodeGroup>

```javascript theme={null}
import { sunra } from "@sunra/client";

const result = await sunra.subscribe("kling/kling-v2-master/image-to-video", {
  input: {
  	prompt: '一隻可愛的倉鼠悠閒地躺在救生圈上，戴著時尚的太陽眼鏡，在波光粼粼的海面上隨波逐流。倉鼠舒適地斜倚著，享受著寧靜愉快的時光。卡通風格，鏡頭跟隨主體移動，畫面溫馨且畫質高。',
  	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);
```

### 如何選擇要使用的模型

sunra 提供多種影片生成模型。您可以根據您想生成的影片風格和品質，選擇最適合您需求的模型。以下是一些可用的模型：

* [kling/kling-v2-master/text-to-video](https://sunra.ai/models/kling/kling-v2-master/text-to-video)：Kling V2 Master 旨在提高提示遵循度、動態效果和視覺美感。
* [wan/wan2.1-vace-14b/text-to-video](https://sunra.ai/models/wan/wan2.1-vace-14b/text-to-video)：一個用於影片創作和編輯的 14B 一體化模型，支援文字轉影片、圖像轉影片等任務，具有多模態輸入和進階控制功能。
* [vidu/viduq1/text-to-video](https://sunra.ai/models/vidu/viduq1/text-to-video)：Vidu Q1 — 極致品質，具有清晰的視覺效果、電影般的過渡、精確的聲音和富有表現力的動畫。
* [minimax/t2v-01-director/text-to-video](https://sunra.ai/models/minimax/t2v-01-director/text-to-video)：此「攝影機控制」模型讓使用者能以專業導演般的流暢度運用電影語言，並進行細緻的創意控制。

若要選擇模型，只需在 subscribe 方法中指定模型 ID，如上例所示。您可以在 [文字轉影片模型](https://sunra.ai/models?modalities%5B0%5D=modality-text-video) 頁面中找到更多模型及其說明。