Pixverse PixVerse V6 Reference To Video API | 요금 및 문서

pixverse/pixverse-v6/reference-to-video

PixVerse V6 비디오 참조는 작업별 프롬프트와 소스 미디어를 1~15초 타이밍, 해상도 제어 및 선택적 기본 오디오를 갖춘 지향성 비디오로 전환합니다.

1. 시작하기

RunComfy API로 pixverse/pixverse-v6/reference-to-video을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/pixverse/pixverse-v6/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A trail runner sprints along a red-rock canyon ridge at golden hour; dust kicks up behind each stride as the camera tracks from the side, athletic cinematic motion."
  }'

2. 인증

환경 변수 YOUR_API_TOKEN 에 API 키를 설정하세요( 프로필에서 키 관리). 모든 요청에 Authorization 헤더로 Bearer 토큰을 포함: Authorization: Bearer $YOUR_API_TOKEN.

3. API 참조

요청 제출

비동기 생성 작업을 제출하면 즉시 request_id와 상태 확인·결과 조회·취소용 URL을 받습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/pixverse/pixverse-v6/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A trail runner sprints along a red-rock canyon ridge at golden hour; dust kicks up behind each stride as the camera tracks from the side, athletic cinematic motion."
  }'

요청 상태 확인

request_id의 현재 상태를 가져옵니다("in_queue", "in_progress", "completed", "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

결과 가져오기

지정한 request_id의 최종 출력과 메타데이터를 가져옵니다. 작업이 완료되지 않았으면 현재 상태가 반환되어 폴링을 계속할 수 있습니다.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

요청 취소

request_id로 대기 중인 작업을 취소합니다. 진행 중인 작업은 취소할 수 없습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 파일 입력

호스트 파일(URL)

공개적으로 접근 가능한 HTTPS URL을 제공하세요. 서버 측 페치가 가능하고(로그인/쿠키 불필요) 속도 제한이나 봇 차단이 없어야 합니다. 권장: 이미지 ≤ 50MB(약 4K), 동영상 ≤ 100MB(720p 기준 약 2–5분). 비공개 자산은 안정적이거나 사전 서명 URL을 권장합니다.

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "장면, 동작, 카메라 움직임 및 참조가 결과를 안내하는 방법을 설명합니다.",
      "type": "string",
      "default": "A trail runner sprints along a red-rock canyon ridge at golden hour; dust kicks up behind each stride as the camera tracks from the side, athletic cinematic motion."
    },
    "images": {
      "title": "참조 이미지",
      "description": "주제, 객체 또는 시각적 정체성을 안내하는 데 사용되는 이미지 URL입니다.",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7445/media-files/input.webp"
      ],
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 7
    },
    "videos": {
      "title": "참고 영상",
      "description": "동작이나 모양을 안내하는 데 사용되는 선택적 비디오 URL입니다. 비디오 참조 실행은 문서화된 2x 속도를 사용합니다.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      }
    },
    "aspect_ratio": {
      "title": "종횡비",
      "description": "생성된 비디오의 프레임 모양입니다.",
      "type": "string",
      "default": "16:9",
      "enum": [
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16",
        "2:3",
        "3:2",
        "21:9"
      ]
    },
    "resolution": {
      "title": "해상도",
      "description": "비디오 해상도로 표시되는 출력 품질 계층.",
      "type": "string",
      "default": "720p",
      "enum": [
        "360p",
        "540p",
        "720p",
        "1080p"
      ]
    },
    "duration": {
      "title": "기간",
      "description": "요청된 출력 기간은 1~15초입니다. 업스트림 API는 비디오 참조가 타이밍을 결정할 때 0을 사용할 수 있습니다. UI는 이미지 전용 모드에 대해 1-15를 노출합니다.",
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 15
    },
    "generate_audio_switch": {
      "title": "오디오 생성",
      "description": "비디오와 함께 선택적 네이티브 오디오 트랙을 생성합니다.",
      "type": "boolean",
      "default": false
    },
    "seed": {
      "title": "종자",
      "description": "세대를 재현하거나 변화시키는 데 사용되는 종자입니다.",
      "type": "integer",
      "default": 0
    }
  }
}

출력 스키마

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "단일 이미지 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "단일 동영상 URL"
      },
      "images": {
        "type": "array",
        "description": "여러 이미지 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "여러 동영상 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy는 최고의 ComfyUI 플랫폼으로서 ComfyUI 온라인 환경과 서비스를 제공하며 ComfyUI 워크플로우 멋진 비주얼을 제공합니다. RunComfy는 또한 제공합니다 AI Models, 예술가들이 최신 AI 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.

1. 시작하기

RunComfy API로 pixverse/pixverse-v6/reference-to-video을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/pixverse/pixverse-v6/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A trail runner sprints along a red-rock canyon ridge at golden hour; dust kicks up behind each stride as the camera tracks from the side, athletic cinematic motion."
  }'

3. API 참조

요청 제출

비동기 생성 작업을 제출하면 즉시 request_id와 상태 확인·결과 조회·취소용 URL을 받습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/pixverse/pixverse-v6/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A trail runner sprints along a red-rock canyon ridge at golden hour; dust kicks up behind each stride as the camera tracks from the side, athletic cinematic motion."
  }'

요청 상태 확인

request_id의 현재 상태를 가져옵니다("in_queue", "in_progress", "completed", "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

결과 가져오기

지정한 request_id의 최종 출력과 메타데이터를 가져옵니다. 작업이 완료되지 않았으면 현재 상태가 반환되어 폴링을 계속할 수 있습니다.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

요청 취소

request_id로 대기 중인 작업을 취소합니다. 진행 중인 작업은 취소할 수 없습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "장면, 동작, 카메라 움직임 및 참조가 결과를 안내하는 방법을 설명합니다.",
      "type": "string",
      "default": "A trail runner sprints along a red-rock canyon ridge at golden hour; dust kicks up behind each stride as the camera tracks from the side, athletic cinematic motion."
    },
    "images": {
      "title": "참조 이미지",
      "description": "주제, 객체 또는 시각적 정체성을 안내하는 데 사용되는 이미지 URL입니다.",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7445/media-files/input.webp"
      ],
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 7
    },
    "videos": {
      "title": "참고 영상",
      "description": "동작이나 모양을 안내하는 데 사용되는 선택적 비디오 URL입니다. 비디오 참조 실행은 문서화된 2x 속도를 사용합니다.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      }
    },
    "aspect_ratio": {
      "title": "종횡비",
      "description": "생성된 비디오의 프레임 모양입니다.",
      "type": "string",
      "default": "16:9",
      "enum": [
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16",
        "2:3",
        "3:2",
        "21:9"
      ]
    },
    "resolution": {
      "title": "해상도",
      "description": "비디오 해상도로 표시되는 출력 품질 계층.",
      "type": "string",
      "default": "720p",
      "enum": [
        "360p",
        "540p",
        "720p",
        "1080p"
      ]
    },
    "duration": {
      "title": "기간",
      "description": "요청된 출력 기간은 1~15초입니다. 업스트림 API는 비디오 참조가 타이밍을 결정할 때 0을 사용할 수 있습니다. UI는 이미지 전용 모드에 대해 1-15를 노출합니다.",
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 15
    },
    "generate_audio_switch": {
      "title": "오디오 생성",
      "description": "비디오와 함께 선택적 네이티브 오디오 트랙을 생성합니다.",
      "type": "boolean",
      "default": false
    },
    "seed": {
      "title": "종자",
      "description": "세대를 재현하거나 변화시키는 데 사용되는 종자입니다.",
      "type": "integer",
      "default": 0
    }
  }
}

출력 스키마

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "단일 이미지 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "단일 동영상 URL"
      },
      "images": {
        "type": "array",
        "description": "여러 이미지 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "여러 동영상 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

PixVerse V6 비디오 참조는 작업별 프롬프트와 소스 미디어를 1~15초 타이밍, 해상도 제어 및 선택적 기본 오디오를 갖춘 지향성 비디오로 전환합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

PixVerse V6 비디오 참조는 작업별 프롬프트와 소스 미디어를 1~15초 타이밍, 해상도 제어 및 선택적 기본 오디오를 갖춘 지향성 비디오로 전환합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

PixVerse V6 비디오 참조: Models and API의 비디오 생성 참조 | RunComfy

PixVerse V6 비디오 참조는 작업별 프롬프트와 소스 미디어를 1~15초 타이밍, 해상도 제어 및 선택적 기본 오디오를 갖춘 지향성 비디오로 전환합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

PixVerse V6 비디오 참조: Models and API의 비디오 생성 참조 | RunComfy

PixVerse V6 비디오 참조는 작업별 프롬프트와 소스 미디어를 1~15초 타이밍, 해상도 제어 및 선택적 기본 오디오를 갖춘 지향성 비디오로 전환합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마