Zum Hauptinhalt springen
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
}
Verwenden Sie diesen Endpunkt, wenn Sie die Runway-Reverse-Format-Route generate mit einem oder mehreren Referenzbildern nutzen möchten.

Bevor Sie ihn aufrufen

  • Senden Sie den erforderlichen Header X-Runway-Version, zum Beispiel 2024-11-06
  • Verwenden Sie model: gen4
  • Geben Sie das Quell-image und den Prompt an, der Bewegung oder Transformation beschreibt
  • Halten Sie die erste Anfrage einfach, bevor Sie Stil- und Bewegungsvektor-Abstimmung hinzufügen

Aufgabenablauf

1

Die Reverse-Format-Aufgabe erstellen

Übermitteln Sie den Prompt, das Bild, das Seitenverhältnis und die Optionen und speichern Sie dann die zurückgegebene Task-ID.
2

Die Aufgabe abfragen

Fahren Sie mit Feed Get Task fort. Wenn die erste Abfrage task_not_exist zurückgibt, warten Sie einige Sekunden und versuchen Sie es erneut.
3

Das Ergebnis speichern

Wenn die Aufgabe abgeschlossen ist, speichern Sie das finale Asset in Ihrer eigenen Medienpipeline, falls Sie eine lange Aufbewahrung benötigen.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

X-Runway-Version
string

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

Body

application/json
callback_url
string
Standard:https://example.com/webhook
erforderlich

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

ratio
string
Standard:1280:720
erforderlich

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

prompt
string
Standard:A paper boat gently rocks on calm water.
erforderlich

Text prompt describing the desired video content or motion.

model
string
Standard:gen4
erforderlich

Model version to use, e.g. gen4.

image
string
Standard:https://db.xiaohuhd.com/1.jpeg
erforderlich

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.

Antwort

200 - application/json

OK

code
integer
erforderlich

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

msg
string
erforderlich

Text description of the status code

data
object
erforderlich

Specific response data content

exec_time
number
erforderlich

Time spent processing this request