# 静止画を動画に
# 概要
YouCam AI 静止画を動画に は、テキストプロンプトと画像を動画に変換します。
AI 技術で、写真に動きの効果を付与します。
画像から AI 動画を作成するには、背景がクリーンで人物がはっきりと写っている写真を使用します。画像をアップロードすると、テキストプロンプトと写真が動画に変換されます。
ユースケース:
## ファイル仕様とエラー
* 対応フォーマットと寸法
|AI 機能|対応寸法|対応ファイルサイズ|対応フォーマット|
| ---- | ---- | ---- | ---- |
| V1.0 画像から動画へ (Standard) |入力: >= 300*300px、アスペクト比 1:2.5 ~ 2.5:1。出力: 最大 720p 30fps|入力: <10MB。出力: 5 秒または 10 秒|jpg/jpeg/png|
| V1.0 画像から動画へ (Professional) |入力: >= 300*300px、アスペクト比 1:2.5 ~ 2.5:1。出力: 最大 1080p 30fps|入力: <10MB。出力: 5 秒または 10 秒|jpg/jpeg/png|
| V2.0 画像から動画へ | 入力画像の長辺は 4096 ピクセル以下、アスペクト比は 1:2.5 から 2.5:1 の範囲である必要があります。
サポートされる出力解像度は 480p、720p、1080p です。入力画像の短辺が選択した解像度を超える場合、または長辺がターゲットサイズより小さい場合、短辺が選択した解像度に一致するように画像が自動的にリサイズされます。 |入力: <10MB。出力: 5 秒または 10 秒|jpg/jpeg/png|
* エラーコード
| エラーカテゴリー | シナリオ / 説明 | 推奨アクション |
| -------------- | ---------------------- | ---------------- |
| 無効なリクエストパラメータ | リクエストパラメータが無効または欠落しています | すべてのリクエストパラメータが正しいことを確認します |
| | 無効なパラメータ値 (例: 不正なキーまたは不正な値) | レスポンスのエラーメッセージフィールドを確認し、リクエストパラメータを更新します |
| | 無効なリクエストメソッド | API ドキュメントを確認し、正しい HTTP メソッドを使用します |
| | リクエストされたリソースが存在しません (例: モデルが見つかりません) | レスポンスのエラーメッセージフィールドを参照し、リクエストパラメータを修正します|
| トリガー戦略 | プラットフォームポリシーがトリガーされました | プラットフォームポリシーに違反していないか確認します |
| | コンテンツセキュリティポリシーがトリガーされました | 入力コンテンツを確認・修正し、リクエストを再送信します |
| | リクエストレートが高すぎます (レート制限超過)| リクエスト頻度を下げ、後で再試行するか、カスタマーサービスに連絡して制限を引き上げます |
| | 同時実行または QPS がクォータを超えています | リクエスト頻度を下げるか、後で再試行します |
| 内部エラー | 内部サーバーエラー | 後で再試行するか、カスタマーサービスに連絡します |
| | サーバーが一時的に利用できません | 後で再試行するか、カスタマーサービスに連絡します |
| | リクエスト滞留による内部タイムアウト| 後で再試行するか、カスタマーサービスに連絡します |
---
## ユニット消費量
| AI 機能 | 消費ユニット |
|---|---|
| AI 静止画を動画に (Standard) V1.0 | 3 (1 秒) * |
| AI 静止画を動画に (Professional) V1.0 | 6 (1 秒) * |
| AI 静止画を動画に (画像から動画へ) V2.0 | 1 ユニット (480p / 1 秒) *
2 ユニット (720p / 1 秒) *
3 ユニット (1080p / 1 秒) * |
| AI 静止画を動画に (テキストから動画へ) V2.0 | 2 ユニット (720p / 1 秒) *
3 ユニット (1080p / 1 秒) * |
> *画像数または動画の長さが割り切れない場合、ユニット数は切り上げられます。
---
License: Privacy policy
## Servers
```
https://yce-api-01.makeupar.com
```
## Security
### BearerAuthenticationV2
[object Object]
Type: http
Scheme: bearer
## Download OpenAPI description
- [静止画を動画に](https://docs.perfectcorp.com/_bundle/@l10n/ja/reference/ai_video_generator.yaml)
## V2.0
- [POST /s2s/v2.0/task/image-to-video/youcam](https://docs.perfectcorp.com/ja/reference/ai_video_generator/v2.0/paths/~1s2s~1v2.0~1task~1image-to-video~1youcam/post.md): AI タスクは非同期です。機能ごとに Webhook がサポートされている場合は、Webhook による完了処理を優先します。Webhook エンドポイントを設定し、Webhook 署名を検証したうえで、`success` または `error` の通知が来たら、受け取った `task_id` を使ってタスクの結果を照会します。設定と検証の詳細は [Webhook 統合ガイド](../develo
- [GET /s2s/v2.0/task/image-to-video/youcam/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_video_generator/v2.0/paths/~1s2s~1v2.0~1task~1image-to-video~1youcam~1%7Btask_id%7D/get.md)
- [POST /s2s/v2.0/task/text-to-video/youcam](https://docs.perfectcorp.com/ja/reference/ai_video_generator/v2.0/paths/~1s2s~1v2.0~1task~1text-to-video~1youcam/post.md): AI タスクは非同期です。機能ごとに Webhook がサポートされている場合は、Webhook による完了処理を優先します。Webhook エンドポイントを設定し、Webhook 署名を検証したうえで、`success` または `error` の通知が来たら、受け取った `task_id` を使ってタスクの結果を照会します。設定と検証の詳細は [Webhook 統合ガイド](../develo
- [GET /s2s/v2.0/task/text-to-video/youcam/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_video_generator/v2.0/paths/~1s2s~1v2.0~1task~1text-to-video~1youcam~1%7Btask_id%7D/get.md)
## V1.0
- [GET /s2s/v2.0/task/template/image-to-video](https://docs.perfectcorp.com/ja/reference/ai_video_generator/v1.0/paths/~1s2s~1v2.0~1task~1template~1image-to-video/get.md)
- [POST /s2s/v2.0/task/image-to-video](https://docs.perfectcorp.com/ja/reference/ai_video_generator/v1.0/paths/~1s2s~1v2.0~1task~1image-to-video/post.md): このエンドポイントは、画像から動画への変換プロセスを開始します。テンプレート ID とソースファイル（URL またはファイル ID 経由）を指定する必要があります。タスクは非同期で処理され、このレスポンスで返される task_id を使用してステータスを確認できます。
- [GET /s2s/v2.0/task/image-to-video/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_video_generator/v1.0/paths/~1s2s~1v2.0~1task~1image-to-video~1%7Btask_id%7D/get.md)