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

# Runway API の概要

> Runway の画像、動画、または音声モデルと対応する CometAPI エンドポイントを選択し、タスク結果を取得します。

CometAPI を通じて Runway モデルを使用し、画像を生成したり、動画を作成または編集したり、
音声やサウンドエフェクトを生成したり、音声を処理したりできます。すべての作成リクエストは
タスク `id` を返します。タスクエンドポイントを使用して、ステータスと出力 URL を取得してください。

## モデルとエンドポイントを選択する

以下のモデルは、これらの Runway エンドポイントを通じて利用できます。各
リンク先のリファレンスでは、対象モデルのパラメータを説明しています。

| タスク                        | モデル ID                                              | エンドポイント                                                    |
| -------------------------- | --------------------------------------------------- | ---------------------------------------------------------- |
| 画像を生成する                    | `gen4_image`, `gen4_image_turbo`                    | [テキストから画像へ](./official-format/generate-an-image-from-text) |
| 画像をアニメーション化する              | `gen4.5`, `gen4_turbo`                              | [画像から動画へ](./official-format/runway-images-raw-video)       |
| テキストから動画を生成する              | `gen4.5`                                            | [テキストから動画へ](./official-format/generate-a-video-from-text)  |
| 動画を編集する                    | `aleph2`                                            | [動画から動画へ](./official-format/generate-a-video-from-a-video) |
| パフォーマンスからキャラクターをアニメーション化する | `act_two`                                           | [キャラクターパフォーマンス](./official-format/control-a-character)     |
| 動画をアップスケールする               | `magnific_video_upscaler_creative`                  | [動画のアップスケール](./official-format/upscale-a-video)            |
| サウンドエフェクトを生成する             | `eleven_text_to_sound_v2`, `seed_audio`             | [サウンドエフェクト](./official-format/generate-sound-effects)      |
| テキストから音声を生成する              | `eleven_multilingual_v2`, `eleven_v3`, `seed_audio` | [テキストから音声へ](./official-format/generate-speech-from-text)   |
| 音声を変換する                    | `eleven_multilingual_sts_v2`                        | [音声から音声へ](./official-format/convert-speech)                |
| 音声を別の言語に吹き替える              | `eleven_voice_dubbing`                              | [音声吹き替え](./official-format/dub-audio)                      |
| 背景音声から音声を分離する              | `eleven_voice_isolation`                            | [音声分離](./official-format/isolate-voice)                    |

`gen4.5` は、テキストから動画へのリクエストと画像から動画へのリクエストの両方をサポートしています。
`gen4_turbo` は画像から動画へのリクエストを使用します。`seed_audio` では、入力
フィールドがサウンドエフェクトとテキストから音声への変換で異なるため、選択したエンドポイントの
モデルバリアントに従ってください。

## タスクを作成して結果を取得する

<Steps>
  <Step title="エンドポイントとモデルを選択する">
    上記のタスクを選択し、そのエンドポイントページにあるモデル固有のリクエストスキーマと
    例を使用してください。
  </Step>

  <Step title="リクエストを送信する">
    [API キーをローカルに用意し、](/ja/overview/quick-start#store-your-api-key-locally)
    `$COMETAPI_KEY` として設定してから、例を実行してください。
    JSON を `https://api.cometapi.com/runwayml/v1` に送信し、その後ろに
    エンドポイントパスを付加します。`Authorization: Bearer <COMETAPI_KEY>` で認証します。
  </Step>

  <Step title="タスク ID を保存する">
    タスク取得リクエスト用に、返された `id` を保存します。
  </Step>

  <Step title="出力を取得する">
    次の操作を使用します： [Runway タスクを取得](./official-format/runway-to-get-task-details)
    同じ CometAPI アカウントの API キーを使用します。`status` が
    `SUCCEEDED`の場合、`output` に記載されているアセットをダウンロードして保存します。
  </Step>
</Steps>

メディア入力には、アクセス可能な HTTPS URL または
エンドポイントスキーマに示されている data URI 形式を使用してください。例のメディア URL は、
例でソース動画または音声ファイルが必要な場合に、ご自身の入力に置き換えてください。