動画モデル上級者向け更新日
POST/v1/videos/generations
viduq3
リクエスト ID viduq3
プロトコル
POST /v1/videos/generations· 動画を生成の例GET /v1/videos/tasks/{id}· 動画タスクを照会の例GET /v1/videos/tasks/{id}/content· 動画をダウンロードの例DELETE /v1/videos/tasks/{id}· 終了済みの動画タスクを削除の例POST /v1/videos/assets· 素材をアップロードの例DELETE /v1/videos/assets/{id}· 素材を削除の例
認証
リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。
Authorization: Bearer YOUR_API_KEY
リクエストパラメータ
POST /v1/videos/generations
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | viduq3. このページに記載のモデル ID を指定します。 |
prompt | string | 条件付き | 場面、動き、カメラワークを記述します。 テキスト指示が必要な場合は、この項目か type: "text" の content 項目を使います。 最大 5000 文字です。 |
content | array<object> | 必須 | 必須の参照素材一覧です。 画像は最大 7 枚です。 |
content[].type | string | 必須 | 指定できる値は text, image_url, input_image です。 |
content[].text | string | 条件付き | type: "text" の項目にプロンプトを指定します。 |
content[].role | string | 条件付き | 通常の参照画像には reference_image を使用します。 通常の参照画像ではロールを省略できます。 |
content[].asset_id | string | 条件付き | POST /v1/videos/assets に素材をアップロードし、返された id を指定します。multipart では kind（image）を file より先に指定します。 |
resolution | string | 任意 | 指定できる値は 540p, 720p, 1080p です。 既定値は 720p です。 |
ratio | string | 任意 | 出力の縦横比です。aspect_ratio でも指定できます。 指定できる値は 1:1, 9:16, 16:9, 3:4, 4:3 です。 既定値は 16:9 です。 |
duration | integer | 任意 | 出力時間を秒で指定します。 3～16 秒の整数を指定します。 既定値は 5 です。 |
generation_mode | string | 任意 | 指定できる値は auto, r2v です。 既定値の auto は素材に合うモードを選択します。モードを指定する場合は素材と一致させます。 |
リクエスト例
API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。
例のメディア URL とアセット ID は、有効な素材に置き換えてください。
Video Generations
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "viduq3",
"prompt": "Move the camera slowly toward the subject in the reference image.",
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"content": [
{
"type": "image_url",
"role": "reference_image",
"asset_id": "YOUR_IMAGE_ASSET_ID"
}
]
}'
動画タスクを照会
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
-H "Authorization: Bearer $ICODEEASY_API_KEY"
動画をダウンロード
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID/content' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-L \
-o result.mp4
終了済みの動画タスクを削除
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-i \
-X DELETE
素材をアップロード
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/assets' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-F 'kind=image' \
-F '[email protected];type=image/png'
素材を削除
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/assets/YOUR_ASSET_ID' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-i \
-X DELETE
レスポンスとタスク
HTTP 202 · タスクの受付
json
{
"id": "vid_1785398400000000000",
"object": "video.generation.job",
"model": "viduq3",
"created_at": "2026-07-30T08:00:00Z",
"status_url": "/v1/videos/tasks/vid_1785398400000000000",
"content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
"status": "queued",
"updated_at": "2026-07-30T08:00:00Z",
"task_id": "vid_1785398400000000000"
}
HTTP 200 · 完了したタスクの取得
json
{
"id": "vid_1785398400000000000",
"object": "video.generation.job",
"model": "viduq3",
"created_at": "2026-07-30T08:00:00Z",
"status_url": "/v1/videos/tasks/vid_1785398400000000000",
"content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
"status": "succeeded",
"updated_at": "2026-07-30T08:01:00Z",
"url": "/v1/videos/tasks/vid_1785398400000000000/content"
}
id を保存します。同じ API キーで status_url に GET リクエストを送り、status が succeeded または failed になるまで確認します。成功後は content_url からダウンロードし、HTTP リダイレクトに従います。どちらのパスも API ベース URL からの相対パスです。
| フィールド | 型 | 説明 |
|---|---|---|
id / task_id | string | タスク ID。作成レスポンスの task_id は id と同じです。 |
status | string | 状態は queued、running、succeeded、failed のいずれかです。 |
progress | integer | 生成の進捗。進捗値が得られない場合は省略されます。 |
error.code | string | タスクが失敗した場合のエラー分類。 |
主なエラー
| HTTP | エラータイプ | 説明 |
|---|---|---|
| 400 | invalid_request | モデル、パラメーターの組み合わせ、参照メディアを確認します。 |
| 401 | unauthorized | API キーが未指定、無効、または停止済みかどうかを確認します。 |
| 402 | insufficient_balance | タスクの送信に必要な残高が不足しています。 |
| 404 | not_found | 照会が 404 の場合はタスク ID を保存し、照会 URL と作成元アカウントの API キーを確認します。既に完了している可能性があるため、この応答だけで再送信しないでください。 |
| 409 | video_not_ready | 動画は生成中です。引き続き状態を確認してください。 |
| 503 | submission_unknown | 送信結果を確認できません。再送信する前にサポートへタスク作成の有無を確認してください。 |
接続ガイド · リクエスト項目、タスクの状態、レスポンス形式は API ガイドを参照してください。
機能と制限
text_to_video· 非対応image_to_video· 対応first_frame· 非対応last_frame· 非対応reference_images· 対応video_input· 非対応audio· 未公開- 制限 解像度: 540p, 720p, 1080p · アスペクト比: 1:1, 9:16, 16:9, 3:4, 4:3 · 参照画像：最大 7 枚 · 長さ: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16 · 入力：Site images ≤10 MB. No audio reference upload. No supplier task IDs.