> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 画像・動画生成

## 1. Nano Banana Pro と Light 版の違いは何ですか？

* Nano Banana Pro：公式正式版に直接接続しており、安定性が高く、完全な機能（参考画像など）をサポートします
* Nano Banana Pro Light：リバース/クラック版で、価格は安いものの安定性は低く、一部機能（参考画像機能など）がサポートされない、または失敗する可能性があり、コンテンツ審査（PROHIBITED\_CONTENT）に引っかかる場合もあります

推奨：本番環境では非 Light 版の使用を推奨します。テスト環境ではコスト削減のため Light 版を使用できます。

## 2. 画像高解像度化（Upscale）API は画像を拡大しただけで、鮮明になりませんか？

現在の Upscale API は主に解像度を上げることで「高解像度化」を実現しており、AI によって詳細を再描画する機能はありません。実際にディテールを強化したい場合は、以下の使用を推奨します：

* Midjourney の Upscale 機能（MJ で生成した画像と組み合わせて使用する必要があります）
* またはその他の専用画像強化モデル

## 3. 画像生成 API が 500 エラーを返す、またはキュー待ち時間が長いのはなぜですか？

考えられる原因：

* リソース不足：ピーク時間帯（午後、夜など）には動画/画像生成タスクがキュー待ち（TASK\_STATUS\_QUEUED）になる可能性があります。ピーク時間帯を避けることを推奨します
* Light 版の不安定性：Light 版を使用している場合、断続的な失敗が発生する可能性があります。リトライするか正式版への切り替えを推奨します
* コンテンツ審査：プロンプトが安全審査に引っかかっている可能性があります（例：Gemini が PROHIBITED\_CONTENT を返す）。プロンプトを修正してください

## 4. 生成された画像 URL にアクセスできませんか？

プラットフォームが返す COS URL は署名付き URL（Presigned URL）で、通常は公開アクセスできます。アクセスできない場合は以下を確認してください：

* URL をコピーする際に途中で切れていないか、余分な文字が追加されていないか
* WeChat ミニプログラムなどのシーンで使用する場合、CORS（クロスオリジン）対応の設定が必要です。プラットフォーム側ではデフォルトで設定済みですが、それでもエラーが出る場合はカスタマーサポートにお問い合わせください

## 5. Sora 2 / Veo 3.1 の生成が遅い、または失敗しますか？

動画生成はリソースを多く消費するタスクです：

* キュー待ちは正常です：ピーク時間帯には 2〜30 分待つ必要がある場合があります
* タスクの消失：30 分以上経っても結果がなく、クエリで "task not found" が返る場合、タスクが失敗した可能性があります。リトライを推奨します
* 横向き/縦向きの問題：一部バージョン（Sora2 など）では横向き/縦向きパラメータが無効になる場合があります。まずはデフォルトの横向きを使用することを推奨します

***

**サポートへのお問い合わせ**

上記 FAQ で問題が解決しない場合は、以下の方法で技術サポートにお問い合わせください：

* 企業 WeChat / WeChat 技術サポートグループ（推奨、最も迅速に対応）
* 提供情報の形式：
  * 問題の説明 + スクリーンショット
  * アカウント ID (UUID)
  * Trace ID（ある場合、通常はエラーメッセージ内にあります）
  * リクエストパラメータ（マスキング後）