用途：通过 Runway 官方 API 创建静态图像，优先使用原生 gen4_image 与 gen4_image_turbo，并明确区分合作方模型。不覆盖视频端点、网页应用界面、非官方封装或第三方网关。
主要能力：支持纯文本生成、参考图引导生成，以及把源图作为参考的自然语言编辑。原生模型接受 promptText（必填，最多 1000 个 UTF-16 单元）、ratio（必选，限指定比例列表）、referenceImages（含 uri 与可选 tag）、seed 和 contentModeration.publicFigureThreshold。gen4_image 接受 0–3 张参考图，Turbo 要求 1–3 张。参考标签需为 3–16 个小写字符并匹配 ^[a-z][a-z0-9_]+$，可在提示词中以 @tag 引用。
使用方式：调用 POST https://api.dev.runwayml.com/v1/text_to_image 创建任务，返回任务 ID；用 GET /v1/tasks/{id} 轮询，DELETE 取消或删除。请求头需带 Authorization: Bearer $RUNWAYML_API_SECRET、Content-Type: application/json 和 X-Runway-Version: 2024-11-06。密钥应保存在服务端密钥管理器。参考图支持 HTTPS URL、data URI 或 runway:// 临时上传 URI，格式限 JPEG、PNG、WebP。
适用场景：文本生成、参考图驱动的风格/身份/构图控制、基于源图的编辑迭代。
限制：无独立的 Gen-4 静态图蒙版/局部重绘路由，编辑需以源图为参考并描述目标结果；无负向提示词、ControlNet、权重等字段。输出 URL 24–48 小时内过期，需及时下载自存。计费与模型目录可能变动，生产前应重新核对官方文档。合作方模型（如 gemini_image3_pro、gpt_image_2、gemini_2.5_flash）契约与价格不同，不可混用字段。