ロールプレイ World を作成します。自然言語プロンプトと必須の最初のフレーム画像から World を作成します。API は暗号化された World ID（encryptedWorldId）を即座に返し、World はバックグラウンドで非同期に構築され、クライアントは構築が完了するまで進捗状況をポーリングします。
スコープ
Acting World を作成します。呼び出す前に、以下を確認してください：
-
認証：プライマリ API Key のみがサポートされています。一時的な API Key は使用できません（エラーコード
403003）。- プライマリ API Key を取得する：API Key の取得と設定。
-
呼び出しモード：非同期モードを推奨します。
- 非同期モード（デフォルト）：
async=trueの場合、API は即座にencryptedWorldIdを返します。進捗状況については World 構築ステータスのクエリをポーリングしてください。 - 同期モード：
async=falseの場合、サーバーは内部でポーリングを行い（3 秒ごと、最大 120 秒）、構築が完了すると応答を返します。タイムアウト時は非同期にフォールバックし、クライアントがポーリングを継続します。
- 非同期モード（デフォルト）：
-
エンドポイントの制限：このエンドポイントは Acting World のみを作成できます。
modeを渡す必要はありません（サーバーが3を書き込みます。3以外の値を渡すと400000が返されます）。creationModelは常にsimpleであり、uploadModeはfirst_frameに固定され、入室バージョンはactingV2に固定されています。
HTTP リクエスト
- Singapore
- 米国（バージニア）
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds{WorkspaceId} を実際の ワークスペースID に置き換えます。リクエストパラメーター |
|
Content-Typestring（必須）リクエストのコンテンツタイプ。このパラメータは application/json に設定する必要があります。 | |
Authorization string （必須）API Key 認証。プライマリ API Key のみがサポートされており、sk- で始まります（例：sk-xxx）。通常、環境変数 $DASHSCOPE_API_KEY として設定されます。一時的な API Key（st- で始まる）を使用すると 403003 が返されます。 | |
リクエストボディ | |
async boolean（オプション）非同期で作成するかどうか。デフォルトは true です：
| |
creationModel string（オプション）作成サブモード。デフォルトは simple です。Acting では simple のみがサポートされています。 | |
prompt string （必須）キャラクター、シーン、および演技目標の自然言語による説明。空ではなく、最大 2000 文字までです。欠落、空白、または長さ超過の場合は 400000 が返されます。 | |
uploadMode string（オプション）画像アップロードモード。デフォルトは first_frame です。Acting では first_frame のみがサポートされています。 | |
resolution string（オプション）ビデオ解像度。デフォルトは 480p です。許可される値：
| |
aspectRatio string（オプション）ストリーミングフレーム比率。これは最初のフレーム画像の向きも決定します。両者を一致させることを推奨します。デフォルトは 9:16 です。許可される値：
9:16）の場合は縦向きの最初のフレームを渡し、横向きストリーミング（16:9）の場合は横向きの最初のフレームを渡します。デフォルトは 9:16 です。横向きが必要な場合は、明示的に aspectRatio=16:9 を渡す必要があります。 | |
refWorldId string（オプション）既存の Acting World から新しい作成物を派生させます。現在のプライマリアカウント配下の Acting 暗号化 World ID である必要があります。別のモデルまたは別のプライマリアカウントの World を指定すると 403001 が返されます。 | |
firstFrameImage object （必須）World の最初のフレームとして再利用される画像参照。url と base64 は排他的です（いずれか一方を選択）。画像の制約事項：
プロパティ url string（条件付き必須）最初のフレーム画像の URL。base64 とは排他的です（いずれか一方を選択）。制約事項：
string（条件付き必須）最初のフレーム画像の base64。url とは排他的です（いずれか一方を選択）。制約事項：
string（オプション）最初のフレーム参照タイプ。デフォルトは default で、現在は default として使用されています。 |
レスポンスパラメーター |
|
code integerリターンコード。0 は成功を意味し、ゼロ以外の値はエラーコードです。 | |
message stringエラーメッセージ。成功時は null、失敗時は人間が読める形式のエラーメッセージです。 | |
data objectレスポンスデータ。失敗時は null です。
プロパティ encryptedWorldId stringサーバーによって生成された暗号化された World ID。同期モードと非同期モードの両方で返されます。後続の構築ステータスポーリング、詳細クエリ、および Travel Credential の交換に使用されます。status string現在の作成ステータス：
stringWorld の最初のフレームの URL。生成前は null です。 |
エラーコード
モデルの呼び出しに失敗してエラーが返された場合は、HappyOyster エラーコードを参照して解決してください。
次のステップ
作成成功後、以下の操作が可能です：
- World 構築ステータスのクエリ：World が
ready状態になるまで、3～5 秒ごとにポーリングします。 - World が
ready状態になった後、Travel Credential の取得を呼び出して、使い捨てのticketと交換します。 - World 詳細のクエリ：完全な作成メタデータをクエリします。