Naar hoofdinhoud gaan
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
}
Gebruik deze endpoint wanneer je de Runway reverse-format generate route met één of meer referentieafbeeldingen wilt gebruiken.

Voordat je deze aanroept

  • Verstuur de vereiste X-Runway-Version header, bijvoorbeeld 2024-11-06
  • Gebruik model: gen4
  • Geef de bron-image en de prompt op die beweging of transformatie beschrijft
  • Houd het eerste verzoek eenvoudig voordat je stijl- en motion-vector-afstemming toevoegt

Taakverloop

1

Maak de reverse-format taak aan

Dien de prompt, image, ratio en opties in en sla vervolgens de geretourneerde task id op.
2

Poll de taak

Ga verder met Feed Get Task. Als de eerste poll task_not_exist retourneert, wacht dan een paar seconden en probeer het opnieuw.
3

Sla het resultaat op

Wanneer de taak is voltooid, sla je de definitieve asset op in je eigen mediapipeline als je langdurige bewaring nodig hebt.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Headers

X-Runway-Version
string

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

Body

application/json
callback_url
string
standaard:https://example.com/webhook
vereist

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

ratio
string
standaard:1280:720
vereist

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

prompt
string
standaard:A paper boat gently rocks on calm water.
vereist

Text prompt describing the desired video content or motion.

model
string
standaard:gen4
vereist

Model version to use, e.g. gen4.

image
string
standaard:https://db.xiaohuhd.com/1.jpeg
vereist

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.

Respons

200 - application/json

OK

code
integer
vereist

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

msg
string
vereist

Text description of the status code

data
object
vereist

Specific response data content

exec_time
number
vereist

Time spent processing this request