April 30, 2025

Updated Runway API v1 endpoint POST frames/create to support optional reference images. See the official References Guide.

Example

imageAssetId1 can be referenced in prompt via @IMG_1
imageAssetId2 can be referenced in prompt via @IMG_2
imageAssetId3 can be referenced in prompt via @IMG_3

CURL

curl --location 'https://api.useapi.net/v1/runwayml/frames/create' \
--header 'Authorization: Bearer user:1234-abcdrfgh' \
--form 'exploreMode="true"' \
--form 'text_prompt="A pretty red-haired lady riding a horse with her pet cat."' \
--form 'aspect_ratio="9:16"' \
--form 'style="high-contrast-warm"' \
--form 'imageAssetId1="user:1234-runwayml:[email protected]:a8b63275-b485-4ed5-b210-41b5a4896be1"' \
--form 'imageAssetId2="user:1234-runwayml:[email protected]:2f4cd3c7-b05c-4ac9-87a1-e6ef2e86f013"' \
--form 'imageAssetId3="user:1234-runwayml:[email protected]:780e1a25-32ca-426a-975c-030bcbb6e5e6"'

CURL with prompt using @IMG_1, @IMG_2 and @IMG_3

curl --location 'https://api.useapi.net/v1/runwayml/frames/create' \
--header 'Authorization: Bearer user:1234-abcdrfgh' \
--form 'exploreMode="true"' \
--form 'text_prompt="@IMG_1 riding a @IMG_2 with @IMG_3"' \
--form 'aspect_ratio="9:16"' \
--form 'style="high-contrast-warm"' \
--form 'imageAssetId1="user:1234-runwayml:[email protected]:a8b63275-b485-4ed5-b210-41b5a4896be1"' \
--form 'imageAssetId2="user:1234-runwayml:[email protected]:2f4cd3c7-b05c-4ac9-87a1-e6ef2e86f013"' \
--form 'imageAssetId3="user:1234-runwayml:[email protected]:780e1a25-32ca-426a-975c-030bcbb6e5e6"'

Result