runwayml-text-to-image の技術仕様
| 仕様 | 詳細 |
|---|---|
| CometAPI 上のモデル ID | runwayml-text-to-image |
| 上流プロバイダー | Runway |
| 主な機能 | 自然言語プロンプトから AI 生成の静止画を作成するテキストから画像の生成。 |
| 最も近い公式 Runway モデルファミリー | Runway の画像生成 API オファリングで、gen4_image と関連する画像モデルを中心に展開。CometAPI はプラットフォーム識別子 runwayml-text-to-image を通じてこれを公開。 |
| 入力タイプ | テキストプロンプト。加えて Runway のより広範な画像 API スタックでは、マルチモーダルな画像生成/編集ワークフロー向けに任意で画像参照を利用可能。 |
| 出力タイプ | 生成画像。 |
| アクセス方法 | Runway の開発者プラットフォームおよび互換統合を通じた API ベースのアクセス。 |
| 認証 | Runway の開発者セットアップフローにおける API キー/API シークレットベースの認証。 |
| SDK の提供状況 | Runway の SDK リソースにより、Node.js および Python 指向のワークフロー向けに公式 SDK サポートあり。 |
| 価格の背景 | Runway は gen4_image の 720p 画像を 1 枚あたり 5 クレジット、1080p 画像を 1 枚あたり 8 クレジットと掲載。gen4_image_turbo は 1 枚あたり 2 クレジットと掲載。正確な CometAPI の課金はプラットフォームにより異なる可能性あり。 |
| 代表的なユースケース | マーケティングビジュアル、コンセプトアート、絵コンテ、プロダクトモックアップ、デザインのアイデーション、その他のクリエイティブな画像生成タスク。これは Runway の画像生成に関するポジショニングに基づく推定。 |
runwayml-text-to-image とは？
runwayml-text-to-image は、Runway 製のテキストから画像生成へアクセスするための CometAPI におけるプラットフォーム識別子です。Runway の公式 API ドキュメントおよび製品資料に基づくと、この機能は自然言語プロンプトを生成画像へ変換するよう設計されており、現在の API モデルラインアップには gen4_image や gen4_image_turbo といった専用の画像モデルが含まれます。
実務上、このモデルカテゴリは、高品質な画像生成をアプリケーション、内部ツール、クリエイティブなワークフロー、またはユーザー向け体験に組み込みたい開発者やプロダクトチームを対象としています。Runway は API を、アプリやプロダクトへ生成メディアを統合するための開発者プラットフォームとして位置づけており、画像 API はプロンプトベースの生成に加え、場合によってはよりコントロールされた出力のための参照画像を用いたワークフローもサポートします。
CometAPI は独自の正規化されたモデル ID 形式を用いるため、CometAPI 経由でモデルを呼び出す際は、Runway のネイティブなドキュメントで gen4_image などの特定の上流モデル名が使われていても、runwayml-text-to-image を使用し続けてください。
runwayml-text-to-image の主な機能
- テキストから画像の生成: 自然言語のプロンプトを、クリエイティブ、ビジュアル、プロダクト指向のワークフローに適した AI 生成画像へ変換。
- Runway の画像モデルによるバックエンド: 専用の画像生成スタック（特に Runway の API モデルカタログで中核となる
gen4_image）に整合。 - 参照画像対応のワークフロー: テキストに加えて画像参照を用いるパターンをサポートし、構図、スタイル、被写体ガイダンスをより細かく制御可能（上流モデルでサポートされる場合）。
- 開発者フレンドリーな API アクセス: ドキュメント、セットアップガイド、SDK を提供し、本番アプリケーションへの統合を容易に。
- 複数の品質/コストオプション:
gen4_imageとgen4_image_turboなど、価格プロファイルの異なる画像モデルを公開しており、出力品質と生成コストの柔軟性を提供。 - クリエイティブ制作用途: アイデーション、アセット生成、ビジュアルプロトタイピング、コンセプト検討、デザイン支援に適合。これは、アプリおよびクリエイティブチーム向け画像生成という Runway の製品ポジショニングに基づくもの。
runwayml-text-to-image へのアクセスと統合方法
ステップ 1: サインアップして API キーを取得
CometAPI にサインアップし、ダッシュボードから API キーを作成します。本番リクエストを行う前に、環境変数またはシークレットマネージャーに安全に保管してください。
ステップ 2: runwayml-text-to-image API にリクエストを送信
CometAPI 経由で Runway の公式 API 形式を使用します。エンドポイントは POST /runwayml/v1/text_to_image です。ヘッダー X-Runway-Version を含めてください。
curl https://api.cometapi.com/runwayml/v1/text_to_image \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "ここにプロンプトを入力してください。"
}'
ステップ 3: 結果の取得と検証
API はタスク ID を含むタスクオブジェクトを返します。GET /runwayml/v1/tasks/{task_id} をポーリングして生成ステータスを確認し、タスク完了後、レスポンスから出力 URL を取得します。