Créer une image 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>"
  }
}

Utilisez ce point de terminaison pour générer une image à partir d’un Prompt, avec des images de référence facultatives pour gen4_image. Envoyez votre clé API CometAPI avec l’authentification Bearer et un corps de requête JSON.

Choisir un modèle et des références

Chaque requête nécessite model, promptText, ratio et referenceImages.

Modèle	`referenceImages`
`gen4_image`	Utilisez `[]` pour une génération à partir de texte uniquement, ou fournissez jusqu’à trois images.
`gen4_image_turbo`	Fournissez une à trois images.

N’omettez pas referenceImages et n’envoyez pas null. Chaque objet de référence contient un uri d’image et un tag facultatif. Utilisez une étiquette de 3 à 16 lettres minuscules, chiffres ou traits de soulignement, commençant par une lettre. Référencez-la dans promptText sous la forme @tag, par exemple @cat_ref. Les URI d’image acceptent des URL HTTPS accessibles ou des URI de données d’image Base64 pouvant atteindre 5 Mo. Le Prompt accepte de 1 à 1 000 unités de code UTF-16.

Choisir les dimensions

Définissez ratio sur l’une des paires de dimensions exactes du schéma. Par exemple, 1024:1024 demande une image carrée, 1280:720 une image au format paysage et 720:1280 une image portrait. Utilisez ratio pour sélectionner les dimensions ; n’envoyez pas resolution size ou avec ces modèles. Pour une graine d’échantillonnage explicite, utilisez 1 à 4294967295. L’omission ou 0 sélectionne une graine aléatoire. Si vous incluez contentModeration, définissez sa publicFigureThreshold sur auto ou low ; sinon, omettez l’objet.

Récupérer le résultat

Enregistrez le id renvoyé et utilisez Obtenir une tâche Runway. Lorsque status est SUCCEEDED, lisez les URL des images générées dans output.

Autorisations

Authorization

string

header

requis

Use your CometAPI API key.

Corps

application/json

gen4_image
gen4_image_turbo

Request parameters for gen4_image.

model

enum<string>

requis

Model ID for this request variant.

Options disponibles:

gen4_image

Allowed value: "gen4_image"

promptText

string

requis

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

Required string length: 1 - 1000

ratio

enum<string>

requis

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

Options 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

referenceImages

object[]

requis

Include this array in every request. Use an empty array for text-only generation, or up to three reference images.

Maximum array length: 3

Show child attributes

seed

integer

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

Plage requise: 0 <= x <= 4294967295

contentModeration

object

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

Show child attributes

Réponse

Task submitted. Save its id to retrieve task status.

string

requis

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

Dernière modification le 18 septembre 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>"
  }
}

Modération de contenu

Clés API

Choisir un modèle et des références

Choisir les dimensions

Récupérer le résultat

Autorisations

Corps

Réponse

​Choisir un modèle et des références

​Choisir les dimensions

​Récupérer le résultat

Autorisations

Corps

Réponse

Choisir un modèle et des références

Choisir les dimensions

Récupérer le résultat