アセットを取得する

可用性

このページには、Modelflare の資産管理ルートが記載されています。呼び出しには、有効なスマート API キーまたはメディアグループ API キー、使用可能なメディアチャネル、および必要な権限が必要です。

エンドポイント

POST https://modelflare.dev/volc/asset/GetAsset

認証

Modelflare API キーを使用します。

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

作成、更新、削除リクエストを含む Idempotency-Key を送信します。同じユーザーに対して同じキーを再試行すると、ミューテーションを繰り返さずに、保存された応答が再生されます。

リクエスト

ID によって 1 つのアセットを読み取ります。このルートを使用して、Status が Active または Failed になるまで非同期アップロードをポーリングします。

フィールド	タイプ	必須	説明	例
`Id`	`string`	はい	クエリするアセット ID。	`asset-20260528140922-d9646`

JSON の例:

{
  "Id": "asset-20260528140922-d9646"
}

cURL の例:

curl --request POST https://modelflare.dev/volc/asset/GetAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Id": "asset-20260528140922-d9646"
}'

レスポンス

リクエストは成功しました。

フィールド	タイプ	必須	説明	例
`Id`	`string`	はい	アセット ID。	`asset-20260528140922-d9646`
`Name`	`string`	いいえ	アセット名。	`character-reference`
`URL`	`string`	いいえ	一時ファイルの URL。文書化された寿命は 12 時間です。これを世代参照として永続化しないでください。	`https://example.com/temporary-asset`
`AssetType`	`Image`	`Video`	`Audio`	いいえ
`GroupId`	`string`	いいえ	所有グループ ID。	`group-20260320141746-zsf6b`
`Status`	`Processing`	`Active`	`Failed`	いいえ
`ProjectName`	`string`	いいえ	プロジェクト名。	`default`
`CreateTime / UpdateTime`	`string`	いいえ	ISO 8601 タイムスタンプ。	`2026-05-28T06:09:31Z`

応答例：

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "AssetType": "Image",
  "GroupId": "group-20260320141746-zsf6b",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

エラー

ステータス	意味
`400`	リクエストは無効です。
`401`	API キーが見つからないか、または不正です。

エラー本文の例 (返された場合):

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

画像、ビデオ、オーディオの作成は非同期です。アセット ID を受信後、ステータスが Active の場合にのみ、GetAsset を呼び出し、asset://<ID> 参照を使用します。