Hopp til hovedinnhold
POST
/
runway
/
pro
/
generate
generate(text)
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",
  "ratio": "16:9",
  "prompt": "a cat",
  "style": "cinematic",
  "model": "gen4",
  "options": {
    "seconds": 10,
    "motion_vector": {
      "x": 0,
      "y": 0.3999999999999999,
      "z": 0,
      "r": -6,
      "bg_x_pan": 0,
      "bg_y_pan": 0
    }
  }
}
'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "task_id": "<string>"
  },
  "exec_time": 123
}
Bruk dette endepunktet for å starte en Runway reverse-format GEN-4 tekst-til-video-oppgave.

Obligatoriske felt i CometAPI

  • callback_url er for øyeblikket påkrevd av wrapperen
  • prompt, ratio, style og model definerer genereringsforespørselen
  • options.seconds og options.motion_vector er påkrevd av det gjeldende wrapper-skjemaet

Validert forespørselsti

  • Header: X-Runway-Version: 2024-11-06
  • Model: gen4_turbo
  • Svar: code: 200, msg: 成功 og data.task_id

Oppgaveflyt

1

Opprett oppgaven

Send inn forespørselen og lagre den returnerte task_id.
2

Poll reverse-format feed-ruten

Fortsett med Feed Get Task for å følge oppgavestatusen.
3

Lagre den ferdige ressursen

Når en video-URL er tilgjengelig, flytt den inn i din egen lagringspipeline.
Hvis du utelater callback_url, returnerer den gjeldende CometAPI-wrapperen callback_url_empty selv om dette er et oppgavebasert asynkront API.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Overskrifter

X-Runway-Version
string

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

Kropp

application/json
callback_url
string
standard:https://example.com/webhook
påkrevd

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

ratio
string
standard:16:9
påkrevd

Aspect ratio of the generated video, e.g. 16:9, 9:16, 1:1.

prompt
string
standard:A cat sitting on a windowsill.
påkrevd

Text prompt describing the video content to generate.

style
string
standard:cinematic
påkrevd

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

model
string
standard:gen4
påkrevd

Model version to use, e.g. gen4.

options
object
påkrevd

Advanced generation options including duration and camera motion.

Svar

200 - application/json

OK

code
integer
påkrevd

HTTP status code or business status code

msg
string
påkrevd

Text description of the status code

data
object
påkrevd

Business data body containing detailed task information

exec_time
number
påkrevd

Execution time of the API interface itself (in seconds), does not represent the total video generation time