> ## 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) ページで、より多くのモデルとその説明を見つけることができます。