Crear una imagen de Runway

POST

runwayml

text_to_image

curl "https://api.cometapi.com/runwayml/v1/text_to_image" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4_image",
  "promptText": "A watercolor portrait of @cat_ref.",
  "ratio": "1024:1024",
  "referenceImages": [
    {
      "uri": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
      "tag": "cat_ref"
    }
  ]
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Usa este endpoint para generar una imagen a partir de un Prompt, con imágenes de referencia opcionales para gen4_image. Envía tu clave de API de CometAPI con autenticación Bearer y un cuerpo de solicitud JSON.

Elige un modelo y referencias

Cada solicitud requiere model, promptText y ratio.

Modelo	`referenceImages`
`gen4_image`	Opcional. Omítelo o usa `[]` para la generación solo con texto, o proporciona hasta tres imágenes.
`gen4_image_turbo`	Proporciona de una a tres imágenes.

Para gen4_image_turbo, referenceImages es obligatorio y debe contener de una a tres imágenes. Cada objeto de referencia contiene una uri de imagen y una tagopcional. Usa una etiqueta de 3 a 16 letras minúsculas, dígitos o guiones bajos, que comience con una letra. Haz referencia a ella en promptText como @tag, por ejemplo @cat_ref. Los URI de imagen aceptan URL HTTPS accesibles o URI de datos de imagen Base64 de hasta 5 MB. El Prompt acepta de 1 a 1000 unidades de código UTF-16.

Elige las dimensiones

Establece ratio en uno de los pares de dimensiones exactos del esquema. Por ejemplo, 1024:1024 solicita una imagen cuadrada, 1280:720 una imagen horizontal y 720:1280 una imagen vertical. Usa ratio para seleccionar las dimensiones; no envíes resolution ni size con estos modelos. Para una semilla de muestreo explícita, usa 1 hasta 4294967295. La omisión o 0 selecciona una semilla aleatoria. Si incluyes contentModeration, establece su publicFigureThreshold en auto o low; de lo contrario, omite el objeto.

Recupera el resultado

Guarda el id devuelto y usa Obtener una tarea de Runway. Cuando status sea SUCCEEDED, lee las URL de las imágenes generadas en output.

Autorizaciones

Authorization

string

header

requerido

Use your CometAPI API key.

Cuerpo

application/json

gen4_image
gen4_image_turbo

Request parameters for gen4_image.

model

enum<string>

requerido

Model ID for this request variant.

Opciones disponibles:

gen4_image

Allowed value: "gen4_image"

promptText

string

requerido

Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.

Required string length: 1 - 1000

ratio

enum<string>

requerido

Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.

Opciones disponibles:

1024:1024,

1080:1080,

1168:880,

1360:768,

1440:1080,

1080:1440,

1808:768,

1920:1080,

1080:1920,

2112:912,

1280:720,

720:1280,

720:720,

960:720,

720:960,

1680:720

seed

integer

Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.

Rango requerido: 0 <= x <= 4294967295

referenceImages

object[]

Optional array of up to three reference images. Omit it or use an empty array for text-only generation.

Maximum array length: 3

Show child attributes

contentModeration

object

Optional content moderation settings. Omit the object to use standard moderation.

Show child attributes

Respuesta

Task submitted. Save its id to retrieve task status.

string

requerido

Task ID for GET /runwayml/v1/tasks/{id}.

status

string

Task state, when returned.

createdAt

string<date-time>

Task submission timestamp, when returned.

output

string<uri>[]

Result URLs, when returned.

failure

string

Failure explanation, when returned.

failureCode

string

Machine-readable failure code, when returned.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Última modificación el 18 de septiembre de 2026

curl "https://api.cometapi.com/runwayml/v1/text_to_image" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4_image",
  "promptText": "A watercolor portrait of @cat_ref.",
  "ratio": "1024:1024",
  "referenceImages": [
    {
      "uri": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
      "tag": "cat_ref"
    }
  ]
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Moderación de contenido

Claves API

Elige un modelo y referencias

Elige las dimensiones

Recupera el resultado

Autorizaciones

Cuerpo

Respuesta

​Elige un modelo y referencias

​Elige las dimensiones

​Recupera el resultado

Autorizaciones

Cuerpo

Respuesta

Elige un modelo y referencias

Elige las dimensiones

Recupera el resultado