메인 콘텐츠로 건너뛰기
POST
/
runway
/
pro
/
generate
Create a reverse-format Runway generate task
curl --request POST \
  --url https://api.cometapi.com/runway/pro/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "callback_url": "http://baidu.com",
  "image": "https://db.xiaohuhd.com/1.jpeg",
  "model": "gen4",
  "prompt": "Smile, Eat Burger"
}
'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "task_id": "<string>"
  },
  "exec_time": 123
}
하나 이상의 참조 이미지와 함께 Runway reverse-format generate 경로를 사용하려면 이 엔드포인트를 사용하세요.

호출 전에 확인할 사항

  • 필수 X-Runway-Version 헤더를 전송하세요. 예: 2024-11-06
  • model: gen4를 사용하세요
  • 원본 image와 움직임 또는 변환을 설명하는 프롬프트를 제공하세요
  • 스타일과 motion-vector 튜닝을 추가하기 전에 첫 번째 요청은 단순하게 유지하세요

작업 흐름

1

reverse-format 작업 생성

프롬프트, 이미지, 비율, 옵션을 제출한 다음 반환된 작업 id를 저장하세요.
2

작업 폴링

Feed Get Task로 계속 진행하세요. 첫 번째 폴링에서 task_not_exist가 반환되면 몇 초 기다린 후 다시 시도하세요.
3

결과 저장

작업이 완료되면 장기 보관이 필요할 경우 최종 asset을 자체 미디어 파이프라인에 저장하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

헤더

X-Runway-Version
string

Optional Runway version header, for example 2024-11-06.

본문

application/json
callback_url
string
기본값:https://example.com/webhook
필수

Webhook URL that receives a POST request with the result when the task completes.

ratio
string
기본값:1280:720
필수

Aspect ratio of the generated video, e.g. 1280:720.

prompt
string
기본값:A paper boat gently rocks on calm water.
필수

Text prompt describing the desired video content or motion.

model
string
기본값:gen4
필수

Model version to use, e.g. gen4.

image
string
기본값:https://db.xiaohuhd.com/1.jpeg
필수

URL of the source image to animate.

style
string

Artistic style for the generated video, e.g. cinematic.

options
object

Advanced generation options.

last_image
string

URL of the end-frame image. When provided, the video transitions toward this frame.

응답

200 - application/json

OK

code
integer
필수

HTTP status code or business status code, 200 usually indicates success

msg
string
필수

Text description of the status code

data
object
필수

Specific response data content

exec_time
number
필수

Time spent processing this request