> ## 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` | [텍스트-이미지](https://apidoc.cometapi.com/ko/api/video/runway/official-format/generate-an-image-from-text.md) |
| 이미지 애니메이션 | `gen4.5`, `gen4_turbo` | [이미지-비디오](https://apidoc.cometapi.com/ko/api/video/runway/official-format/runway-images-raw-video.md) |
| 텍스트로 비디오 생성 | `gen4.5` | [텍스트-비디오](https://apidoc.cometapi.com/ko/api/video/runway/official-format/generate-a-video-from-text.md) |
| 비디오 편집 | `aleph2` | [비디오-비디오](https://apidoc.cometapi.com/ko/api/video/runway/official-format/generate-a-video-from-a-video.md) |
| 퍼포먼스로 캐릭터 애니메이션 | `act_two` | [캐릭터 퍼포먼스](https://apidoc.cometapi.com/ko/api/video/runway/official-format/control-a-character.md) |
| 비디오 업스케일 | `magnific_video_upscaler_creative` | [비디오 업스케일](https://apidoc.cometapi.com/ko/api/video/runway/official-format/upscale-a-video.md) |
| 음향 효과 생성 | `eleven_text_to_sound_v2`, `seed_audio` | [음향 효과](https://apidoc.cometapi.com/ko/api/video/runway/official-format/generate-sound-effects.md) |
| 텍스트에서 음성 생성 | `eleven_multilingual_v2`, `eleven_v3`, `eleven_v4`, `seed_audio` | [텍스트 음성 변환](https://apidoc.cometapi.com/ko/api/video/runway/official-format/generate-speech-from-text.md) |
| 음성 변환 | `eleven_multilingual_sts_v2` | [음성-음성](https://apidoc.cometapi.com/ko/api/video/runway/official-format/convert-speech.md) |
| 오디오를 다른 언어로 더빙 | `eleven_voice_dubbing` | [음성 더빙](https://apidoc.cometapi.com/ko/api/video/runway/official-format/dub-audio.md) |
| 배경 오디오에서 음성 분리 | `eleven_voice_isolation` | [음성 분리](https://apidoc.cometapi.com/ko/api/video/runway/official-format/isolate-voice.md) |

`gen4.5` 텍스트-비디오와 이미지-비디오 요청을 모두 지원합니다.
`gen4_turbo` 이미지-비디오 요청을 사용합니다. `seed_audio`에는 서로 다른 입력
음향 효과와 텍스트 음성 변환에 대한 필드가 있으므로 선택한 엔드포인트의
모델 변형을 따르세요.

## 작업 생성 및 결과 조회

**1. 엔드포인트 및 모델 선택**

위에서 작업을 선택한 다음 모델별 요청 스키마와
해당 엔드포인트 페이지의 예제를 사용하세요.

**2. 요청 전송**

[API 키를 로컬에 저장](https://apidoc.cometapi.com/ko/overview/quick-start.md#store-your-api-key-locally)
하고 예제를 실행하기 전에 `$COMETAPI_KEY`로 설정하세요.
JSON을 `https://api.cometapi.com/runwayml/v1`에 전송한 다음
엔드포인트 경로를 추가하세요. `Authorization: Bearer <COMETAPI_KEY>`로 인증하세요.

**3. 작업 ID 저장**

작업 조회 요청에 사용할 반환된 `id`를 저장하세요.

**4. 출력 조회**

다음을 사용하세요 [Runway 작업 가져오기](https://apidoc.cometapi.com/ko/api/video/runway/official-format/runway-to-get-task-details.md)
동일한 CometAPI 계정의 API 키와 함께 사용하세요. `status`가
`SUCCEEDED`이면, `output`에 나열된 에셋을 다운로드하여 저장하세요.

미디어 입력에는 액세스 가능한 HTTPS URL 또는
엔드포인트 스키마에 표시된 data URI 형식을 사용하세요. 예제 미디어 URL은
예제에서 소스 비디오 또는 오디오 파일을 요구할 경우 자체 입력으로 바꾸세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.