> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# UpdreamをAPIYIに接続
> Updreamの外部モデルコネクタを使用してAPIYIの画像モデルを呼び出し、AIクリエイティブタスクを実行します
Updreamは、Bilibiliのクリエイター、プロフェッショナルクリエイター、コンテンツチーム向けのAI動画作成プラットフォームです。コネクターを介して外部モデルを接続すると、UpdreamのクリエイティブワークフローからAPIYIの画像モデルを呼び出せます。
## Updreamとは？
Updreamは、エージェントとの会話、ノードベースの無限キャンバス、スキルライブラリ、マルチモデル生成を組み合わせ、アイデアや脚本から絵コンテ、アセット、動画制作までのワークフローをサポートします。
1行のアイデア、ストーリー概要、既存の脚本、参考資料から始めて、エージェントとの対話でクリエイティブの方向性を洗練できます。プランを確認した後は、脚本、絵コンテ、キャラクター、シーン、小道具、その他のクリエイティブアセットの作成を続けられます。頻繁に使用するクリエイティブの手法は、スキルとして保存してプロジェクト間で再利用することもできます。
公式サイトでは、以下の主要機能が紹介されています。
* **エージェントによるアイデア創出支援**：自然言語での会話を通じて、クリエイティブの方向性やコンテンツ計画を洗練します。
* **脚本と絵コンテの生成**：アイデアを脚本、絵コンテテーブル、ショット単位のアセットに変換します。
* **無限キャンバスのワークフロー**：テキスト、画像、動画、その他のクリエイティブアセットをノードで整理します。
* **スキルライブラリ**：プロンプト最適化、キャラクターデザイン、スタイルの一貫性を保つ手法を、再利用可能なスキルとして保存します。
* **マルチモデル作成**：タスクごとに画像、動画、その他のモデル機能を選択します。
このガイドでは、Updreamの**外部モデルコネクター**を使用し、APIYIのOpenAI互換設定で画像を生成する方法を説明します。スクリーンショットの例では`gpt-image-2`を使用しています。正確なモデルIDとパラメーターについては、現在のAPIYIモデルドキュメントを確認してください。
## UpdreamをAPIYIに接続する理由
UpdreamをAPIYIに接続すると、次のことが可能になります。
* 1つのAPIキーで外部モデルを設定できます。
* Base URL、APIキー、モデルIDをUpdreamに直接入力できます。
* クリエイティブタスクに応じてAPIYIのモデルを切り替えられます。
* 生成した画像を、ストーリーボード、キャラクター、シーン、その他のクリエイティブアセットとして再利用できます。
* UpdreamのAgent、Skill、キャンバスワークフローを維持できます。
## 開始する前に
以下を準備してください：
* Updream をインストールし、ログイン済みにします。
* 有効な APIYI API キー。
* APIYI アカウントの利用可能な残高。
* 使用するモデル ID（例：`gpt-image-2`）。
API キーは機密性の高い認証情報です。スクリーンショット、ドキュメント、公開チャットに実際のキーを掲載しないでください。タスク完了後に無効化できる一時キーまたは制限付きキーの使用を推奨します。
## ステップ 1：外部モデルコネクタを開く
1. Updreamを開き、左サイドバーで**スキル**を選択します。
2. **スキルマーケットプレイス**を開きます。
3. **外部モデルコネクタ**を検索します。
4. **外部モデルコネクタ**の検索結果を選択します。
5. **今すぐ使用**をクリックします。
詳細ページには、テキストおよび画像入力のサポートと、画像、動画、テキストの出力オプションが表示されます。このガイドでは、スクリーンショットで確認できた画像生成フローのみを説明します。
## ステップ 2：接続プロトコルを選択する
**接続**ステップで、次を選択します。
> **OpenAI 互換（推奨）**
カスタムレスポンスに APIYI Base URL と API キーを入力します。スクリーンショットに表示されている APIYI Base URL は次のとおりです。
```text theme={null}
https://api.apiyi.com/v1
```
このガイドでは、スクリーンショットに示されている OpenAI 互換構成を使用します。Google GenAI、Gemini REST、Seedance、汎用 JSON は、この検証済み構成の対象外です。各プロトコルの要件を確認せずに、このページのパラメーターをそれらのプロトコルで再利用しないでください。
## ステップ 3：タスクタイプを選択する
**タスク**ステップで、次を選択します。
> **画像生成（推奨）**
このオプションでは、prompt から画像を直接生成します。External Model Connector には、画像編集、テキスト生成、動画送信、タスクのポーリングのオプションも表示されます。これらのタスクには、実際のモデル、プロトコル、エンドポイントに基づく個別の設定が必要です。このガイドでは、動画タスクに画像設定を再利用しません。
## ステップ 4：モデルの提供方法を選択する
**モデル**ステップで、次を選択します。
> **モデル名をインターフェース ID として**
このオプションでは、モデルの実際のインターフェース ID が必要です。スクリーンショットの例では、次を使用しています。
```text theme={null}
gpt-image-2
```
APIYI のモデルドキュメントに記載されている正確なモデル ID を使用してください。表示名、カスタムエイリアス、または別のプラットフォームのモデル名は入力しないでください。
## ステップ 5：パラメータの提供方法を選択する
**パラメータ**ステップで、次を選択します。
> **完全なパラメータを自分で指定する（推奨）**
このオプションでは、以降のレスポンスで画像プロンプト、アスペクト比、サイズ、品質、画像数を指定します。Updream には **プロンプトを自動で最適化する** と **一般的なデフォルト値を使用する** オプションもありますが、このガイドではスクリーンショットで確認できる手順の対象外です。
## ステップ 6：API認証情報を入力する
**認証情報**のステップで、次を選択します。
> **今すぐ入力（推奨）**
Updreamの指示に従って、APIYIのベースURLとAPIキーを入力します。ご自身のAPIYIキーを使用し、スクリーンショットに表示されているサンプル値は使用しないでください。
## ステップ 7：モデル名を入力する
**モデル名**のステップで、次を選択します：
> **今すぐ入力（推奨）**
使用するモデル ID を入力します：
```text theme={null}
gpt-image-2
```
モデルを切り替えるには、この値を APIYI で現在サポートされている別の画像モデル ID に置き換え、選択したタスクとの互換性を確認します。
## ステップ 8：画像プロンプトを入力する
**プロンプト**ステップで、次を選択します。
> **元のテキストを使用（推奨）**
次に、画像プロンプトを入力します。例：
```text theme={null}
Wind blowing through a wheat field
```
対象、構図、カメラ、照明、視覚的な制約などの詳細をUpdreamに追加させたい場合は、代わりに**最適化を許可**を選択します。**元のテキストを使用**では、入力した内容のままプロンプトが送信されます。
## ステップ 9：出力パラメータを選択する
**出力**ステップで、次を選択します。
> **1:1 · 1K · シングル（推奨）**
スクリーンショットには、次の設定が表示されています。
| パラメータ | 設定 |
| ------ | --- |
| アスペクト比 | 1:1 |
| 解像度 | 1K |
| 画像数 | 1枚 |
| 品質 | 中品質 |
Updream には、`16:9 · 2K · Single`、`9:16 · 2K · Single`、および**カスタム完全パラメータ**も表示されます。利用できるサイズ、品質、画像数は、選択したモデルによって異なります。モデルのドキュメントと、インターフェースで現在利用できるオプションに従ってください。
## ステップ10：APIYIの設定を送信する
前の選択を完了すると、Updreamから指定された形式で設定を送信するよう求められます。スクリーンショットには、次の形式の例が示されています。
```text theme={null}
Base URL: https://api.apiyi.com/v1
API Key: YOUR_API_KEY
Model: gpt-image-2
Prompt: Wind blowing through a wheat field
```
送信する前に、以下を確認してください。
* ベースURLが`https://api.apiyi.com/v1`であること。
* APIキーが自身のAPIYIキーに置き換えられていること。
* モデルIDが正しいこと。
* promptに画像要件がすべて含まれていること。
* 出力サイズ、品質、数が、選択したモデルの能力の範囲内であること。
## ステップ 11：生成結果を確認する
送信後、Updreamに生成結果が表示されます。スクリーンショットの例では、次のようになっています。
* モデル：`gpt-image-2`
* プロンプト：`Wind blowing through a wheat field`
* フォーマット：1:1
* 解像度：1024 × 1024
* 枚数：1枚
生成された画像は、Updreamのクリエイティブワークフローで引き続き参照素材として使用できます。特定のノードやタスクに接続できるかどうかは、そのタスクの入力タイプと、選択したモデルの機能によって異なります。
## 最新のモデル推奨を見る
現在のモデル推奨、機能比較、利用ガイダンスをご確認いただけます。リストは継続的に更新されています。
モデル ID とインターフェースパラメータは時間の経過とともに変更されます。現在の ID、画像サイズ、品質オプション、タスク制限については、APIYI のモデル推奨と選択したモデルのドキュメントをご確認ください。
## FAQ
このガイドで検証しているOpenAI互換フローでは、`https://api.apiyi.com/v1`を使用してください。その他のプロトコルでは異なるアドレスとパラメータを使用するため、この設定と混在させないでください。
APIYIのドキュメントに記載されている正確なモデルIDを入力してください。たとえば、スクリーンショットに示されている`gpt-image-2`などです。モデルIDのスペルを間違えると、モデルが見つからないエラーやリクエストエラーが発生する場合があります。
推奨されません。可能な場合は一時的なキーまたは権限を制限したキーを使用し、タスクの完了後に使用していない認証情報を失効または削除してください。
できると考えないでください。外部モデルコネクタのインターフェースには動画の送信とタスクのポーリングが表示されますが、動画タスクには実際のモデル、プロトコル、パラメータに基づく個別の設定が必要です。このガイドでは画像生成のみを検証しています。
APIキーが有効か、ベース URLが`https://api.apiyi.com/v1`か、モデルIDが正しいか、モデルが選択した画像タスクに対応しているか、そしてAPIYIアカウントの残高が十分かを確認してください。問題が続く場合は、Updreamのタスクメッセージと、APIYIから返されたエラーの両方を確認してください。
画像モデルはpromptを解釈し、そこから画像を生成します。関係のない詳細を削除する、被写体と構図を明確にする、重要な要件をpromptの前半に配置する、または**最適化を許可**をオフにして元のpromptを送信する、といった方法を試してください。
## 関連リソース
`www.updream.cn`
現在のモデル、機能、利用ガイダンスをご確認いただけます。
APIキーを取得・管理できます。
APIの統合とAPI呼び出しについて説明します。