文生视频

{
  "contentType": "application/json",
  "properties": {
    "contents": {
      "description": "【替代】提示词数组写法，与顶层 prompt 二选一。每项 type 必须为 \"prompt\"（文生不支持 first_frame）。网关会提取 contents[].text 转为顶层 prompt 后转发上游。",
      "items": {
        "additionalProperties": false,
        "properties": {
          "text": {
            "description": "提示词文本，最多 3072 字符。",
            "maxLength": 3072,
            "minLength": 1,
            "type": "string",
            "x-i18n": {
              "en-US": {
                "description": "Prompt text, max 3072 characters."
              }
            }
          },
          "type": {
            "const": "prompt",
            "description": "文生视频固定为 \"prompt\"，传入 \"first_frame\" 会报 400。",
            "type": "string",
            "x-i18n": {
              "en-US": {
                "description": "text-to-video type must be \"prompt\"; \"first_frame\" returns 400."
              }
            }
          }
        },
        "required": [
          "type",
          "text"
        ],
        "type": "object"
      },
      "minItems": 1,
      "type": "array",
      "x-i18n": {
        "en-US": {
          "description": "[Alternative] Prompt array form, mutually exclusive with top-level prompt. Each item type must be \"prompt\" (text-to-video does not support first_frame). Gateway extracts contents[].text into top-level prompt then forwards upstream."
        }
      }
    },
    "options": {
      "additionalProperties": false,
      "description": "任务控制参数，全部可选。",
      "properties": {
        "callback_url": {
          "description": "任务完成后上游回调的 URL（需公网可访问）。",
          "format": "uri",
          "type": "string",
          "x-i18n": {
            "en-US": {
              "description": "Upstream callback URL after task completion (must be publicly accessible)."
            }
          }
        },
        "external_task_id": {
          "description": "业务侧自定义任务 ID，便于幂等查询和对账。",
          "type": "string",
          "x-i18n": {
            "en-US": {
              "description": "Caller-defined external task ID for idempotent queries and reconciliation."
            }
          }
        },
        "watermark_info": {
          "description": "水印配置，结构由上游定义，原样透传。",
          "properties": {},
          "type": "object",
          "x-i18n": {
            "en-US": {
              "description": "Watermark config defined by upstream, passed through as-is."
            }
          }
        }
      },
      "type": "object",
      "x-i18n": {
        "en-US": {
          "description": "Task control parameters, all optional."
        }
      }
    },
    "prompt": {
      "description": "【推荐】顶层提示词。最多 3072 字符。全角标点（，；：）由网关自动转为半角。与 contents[] 二选一，同时传入时 contents[] 被忽略。",
      "maxLength": 3072,
      "minLength": 1,
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "[Recommended] top-level prompt. max 3072 characters. full-width punctuation(, ; : )auto-converted to half-width by the gateway. Mutually exclusive with contents[]; if both are set, contents[] is ignored."
        }
      }
    },
    "settings": {
      "additionalProperties": false,
      "description": "生成参数，全部可选。缺失时网关自动补默认值：resolution=720p, aspect_ratio=16:9, duration=5。",
      "properties": {
        "aspect_ratio": {
          "default": "16:9",
          "description": "画面宽高比，默认 16:9。",
          "enum": [
            "16:9",
            "9:16",
            "1:1"
          ],
          "type": "string",
          "x-apifox-enum": [
            {
              "description": "默认值，适合横屏/桌面端",
              "name": "横屏 16:9",
              "value": "16:9"
            },
            {
              "description": "适合短视频/手机竖屏",
              "name": "竖屏 9:16",
              "value": "9:16"
            },
            {
              "description": "适合社交媒体方形封面",
              "name": "方形 1:1",
              "value": "1:1"
            }
          ],
          "x-i18n": {
            "en-US": {
              "description": "Aspect ratio, default 16:9."
            }
          }
        },
        "duration": {
          "default": 5,
          "description": "视频时长（秒），范围 3–15，默认 5。计费金额与时长线性正相关。",
          "maximum": 15,
          "minimum": 3,
          "type": "integer",
          "x-i18n": {
            "en-US": {
              "description": "Video duration (seconds), range 3–15, default 5. Billing scales linearly with duration."
            }
          }
        },
        "resolution": {
          "default": "720p",
          "description": "输出分辨率，默认 720p。1080p 计费约 1.25×。",
          "enum": [
            "720p",
            "1080p"
          ],
          "type": "string",
          "x-apifox-enum": [
            {
              "description": "默认值；基准计费倍率",
              "name": "标清 720p",
              "value": "720p"
            },
            {
              "description": "计费倍率约 1.5×，画质更高",
              "name": "高清 1080p",
              "value": "1080p"
            }
          ],
          "x-i18n": {
            "en-US": {
              "description": "Output resolution, default 720p. 1080p bills ~1.25×."
            }
          }
        }
      },
      "type": "object",
      "x-i18n": {
        "en-US": {
          "description": "Generation params, all optional. Gateway defaults when missing: resolution=720p, aspect_ratio=16:9, duration=5."
        }
      }
    }
  },
  "required": []
}

{
  "contents": [
    {
      "text": "A cat running",
      "type": "prompt"
    }
  ],
  "settings": {
    "duration": 5,
    "resolution": "720p"
  }
}

{
  "prompt": "Young woman walking through neon-lit Tokyo street at night, slow motion",
  "settings": {
    "aspect_ratio": "9:16",
    "duration": 5,
    "resolution": "720p"
  }
}

{
  "prompt": "Coffee being poured into a glass cup, macro shot, warm tones",
  "settings": {
    "aspect_ratio": "1:1",
    "duration": 5,
    "resolution": "720p"
  }
}

{
  "prompt": "Epic aerial view of Zhangjiajie mountains emerging from clouds, golden hour, cinematic drone footage",
  "settings": {
    "aspect_ratio": "16:9",
    "duration": 10,
    "resolution": "1080p"
  }
}

{
  "prompt": "Fashion model walking on runway, dynamic lighting, high fashion editorial style",
  "settings": {
    "aspect_ratio": "9:16",
    "duration": 15,
    "resolution": "1080p"
  }
}

{
  "contents": [
    {
      "text": "Autumn leaves falling in a Japanese garden, koi pond reflections, peaceful atmosphere",
      "type": "prompt"
    }
  ],
  "options": {
    "callback_url": "https://your-server.com/webhook/kling",
    "external_task_id": "biz-order-20240623-001"
  },
  "settings": {
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "720p"
  }
}

{
  "prompt": "Shot 1,2,a young woman stands at window looking outside, morning light filters in;Shot 2,3,she turns around with a smile, coffee cup in hand;Shot 3,5,she walks to the balcony, city skyline in background, golden hour;",
  "settings": {
    "aspect_ratio": "16:9",
    "duration": 10,
    "resolution": "1080p"
  }
}