Video & Image Generator🔹Maker🔹Editor · GPT アクション

{
  "openapi": "3.1.0",
  "info": {
    "title": "Clipwave Video Creator API (Proxy)",
    "description": "Pre-fill video projects on Clipwave via Analytics Proxy. Creates a link the user can open to see their project setup.",
    "version": "1.1.0"
  },
  "servers": [
    {
      "url": "https://airesearchplus.com"
    }
  ],
  "paths": {
    "/wp-json/cv/v1/proxy/clipwave": {
      "post": {
        "operationId": "createPrefill",
        "summary": "Create a pre-filled video project",
        "description": "Creates a video project with the given settings and returns a URL the user can open to start generating. IMPORTANT: Always set source to 'gilam'. Always display the returned URL as a clickable link to the user.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "x-openai-isConsequential": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PrefillRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Pre-fill created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrefillResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - missing required fields"
          },
          "401": {
            "description": "Unauthorized - invalid API key"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PrefillRequest": {
        "type": "object",
        "required": [
          "product_description",
          "source"
        ],
        "properties": {
          "product_description": {
            "type": "string",
            "description": "Description of the product or service to create a video for"
          },
          "product_url": {
            "type": "string",
            "description": "URL of the product page (optional)"
          },
          "video_type": {
            "type": "string",
            "enum": [
              "ugc_ad",
              "podcast_clip",
              "testimonial",
              "product_demo",
              "transformation"
            ],
            "default": "ugc_ad",
            "description": "Type of video to create."
          },
          "target_audience": {
            "type": "string",
            "description": "Target audience for the video (e.g. 'women 25-40 interested in skincare')"
          },
          "language": {
            "type": "string",
            "enum": [
              "English",
              "Spanish",
              "Portuguese",
              "Korean",
              "Japanese",
              "Mandarin",
              "Indonesian"
            ],
            "default": "English",
            "description": "Language for the script and voice-over"
          },
          "tone": {
            "type": "string",
            "enum": [
              "energetic",
              "friendly",
              "professional",
              "urgent"
            ],
            "default": "energetic",
            "description": "Tone of the video"
          },
          "duration": {
            "type": "integer",
            "enum": [
              8,
              15,
              30,
              45
            ],
            "default": 15,
            "description": "Target video duration in seconds"
          },
          "aspect_ratio": {
            "type": "string",
            "enum": [
              "9:16",
              "16:9",
              "1:1",
              "4:5"
            ],
            "default": "9:16",
            "description": "Video aspect ratio."
          },
          "source": {
            "type": "string",
            "enum": [
              "gilam"
            ],
            "default": "gilam",
            "description": "Attribution source. Always set to 'gilam'."
          }
        }
      },
      "PrefillResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "url": {
            "type": "string",
            "description": "URL for the user to open their pre-filled project. Always display this as a clickable link."
          },
          "prefill_id": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-CV-SECRET"
      }
    }
  }
}

{
  "openapi": "3.1.0",
  "info": {
    "title": "Clipwave Media Forge API",
    "description": "Direct image and video generation on Clipwave. Creates a link the user can open to see their project setup.",
    "version": "1.3.1"
  },
  "servers": [
    {
      "url": "https://clipwave.io"
    }
  ],
  "paths": {
    "/api/gpt/media-forge-prefill": {
      "post": {
        "operationId": "createMediaForgePrefill",
        "summary": "Create a pre-filled Media Forge project",
        "description": "Creates a Media Forge project and returns a URL the user can open to start generating. IMPORTANT: Always set source to 'gpt-media-forge'. Always display the returned URL as a clickable link to the user.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MediaForgeRequest"
              }
            }
          }
        },
        "x-openai-isConsequential": false,
        "responses": {
          "200": {
            "description": "Pre-fill created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrefillResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - missing or invalid fields"
          },
          "401": {
            "description": "Unauthorized - invalid API key"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "MediaForgeRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "tab",
          "prompt",
          "model_id",
          "source"
        ],
        "properties": {
          "tab": {
            "type": "string",
            "enum": [
              "image",
              "video"
            ],
            "description": "Media type: 'image' or 'video'."
          },
          "prompt": {
            "type": "string",
            "description": "Prompt used in Media Forge."
          },
          "model_id": {
            "type": "string",
            "description": "Exact Media Forge model endpoint id.",
            "enum": [
              "fal-ai/flux-pro",
              "fal-ai/flux/dev",
              "fal-ai/flux-pro/v1.1-ultra",
              "fal-ai/flux-2",
              "fal-ai/flux-2-pro",
              "fal-ai/flux-2/lora",
              "fal-ai/bytedance/seedream/v4.5/text-to-image",
              "fal-ai/bytedance/seedream/v5/lite/text-to-image",
              "fal-ai/gemini-25-flash-image",
              "fal-ai/gemini-3-pro-image-preview",
              "fal-ai/nano-banana-2",
              "fal-ai/gpt-image-1.5",
              "fal-ai/gpt-image-1/text-to-image",
              "xai/grok-imagine-image",
              "fal-ai/gpt-image-1.5/edit",
              "xai/grok-imagine-image/edit",
              "fal-ai/flux-pro/kontext",
              "fal-ai/bytedance/seedream/v4.5/edit",
              "fal-ai/flux-2/edit",
              "fal-ai/flux-2-pro/edit",
              "fal-ai/flux-2/lora/edit",
              "fal-ai/bytedance/seedream/v5/lite/edit",
              "fal-ai/fashn/tryon/v1.6",
              "fal-ai/kling/v1-5/kolors-virtual-try-on",
              "fal-ai/cat-vton",
              "fal-ai/esrgan",
              "fal-ai/clarity-upscaler",
              "fal-ai/topaz/upscale/image",
              "fal-ai/ccsr",
              "fal-ai/crystal-upscaler",
              "fal-ai/veo3.1/image-to-video",
              "fal-ai/veo3.1/fast/image-to-video",
              "fal-ai/kling-video/v3/pro/image-to-video",
              "fal-ai/kling-video/v3/pro/text-to-video",
              "fal-ai/kling-video/v3/standard/image-to-video",
              "fal-ai/kling-video/v3/standard/text-to-video",
              "fal-ai/kling-video/v2.6/pro/image-to-video",
              "fal-ai/kling-video/v2.6/pro/text-to-video",
              "fal-ai/kling-video/v2.6/pro/motion-control",
              "fal-ai/kling-video/v2.6/standard/motion-control",
              "bytedance/seedance-2.0/image-to-video",
              "bytedance/seedance-2.0/text-to-video",
              "bytedance/seedance-2.0/fast/text-to-video",
              "fal-ai/bytedance/seedance/v1/lite/image-to-video",
              "fal-ai/bytedance/seedance/v1/lite/text-to-video",
              "fal-ai/kling-video/o3/pro/image-to-video",
              "fal-ai/kling-video/o3/pro/text-to-video",
              "fal-ai/bytedance/seedance/v1.5/pro/image-to-video",
              "fal-ai/bytedance/seedance/v1.5/pro/text-to-video",
              "fal-ai/bytedance/seedance/v1/pro/fast/image-to-video",
              "fal-ai/bytedance/seedance/v1/lite/reference-to-video",
              "fal-ai/wan/v2.2-14b/animate/replace",
              "fal-ai/wan/v2.2-14b/animate/move",
              "fal-ai/sora-2/image-to-video",
              "fal-ai/sora-2/text-to-video",
              "fal-ai/sora-2/image-to-video/pro",
              "fal-ai/sora-2/text-to-video/pro",
              "fal-ai/sora-2/video-to-video/remix",
              "xai/grok-imagine-video/image-to-video",
              "fal-ai/topaz/upscale/video"
            ]
          },
          "ratio": {
            "type": "string",
            "description": "Aspect ratio visible in Media Forge.",
            "enum": [
              "auto",
              "1:1",
              "2:3",
              "3:2",
              "3:4",
              "4:3",
              "4:5",
              "5:4",
              "9:16",
              "16:9",
              "21:9"
            ]
          },
          "resolution": {
            "type": "string",
            "description": "Resolution. (e.g. 1K, 2K, 4K for image; 480p, 580p, 720p, 1080p for video).",
            "enum": [
              "1K",
              "2K",
              "4K",
              "480p",
              "580p",
              "720p",
              "1080p"
            ]
          },
          "duration": {
            "type": "integer",
            "description": "Video duration in seconds (visible options in Media Forge by model).",
            "enum": [
              4,
              5,
              6,
              8,
              10,
              15,
              20
            ]
          },
          "count": {
            "type": "integer",
            "minimum": 1,
            "maximum": 4,
            "description": "Image output count."
          },
          "source": {
            "type": "string",
            "enum": [
              "gpt-media-forge"
            ],
            "default": "gpt-media-forge",
            "description": "Attribution source. Always set to 'gpt-media-forge'."
          },
          "advanced_params": {
            "$ref": "#/components/schemas/MediaForgeAdvancedParams"
          }
        }
      },
      "PrefillResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "url": {
            "type": "string",
            "description": "URL for the user to open their pre-filled Media Forge project. Always display this as a clickable link."
          },
          "prefill_id": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "MediaForgeAdvancedParams": {
        "type": "object",
        "additionalProperties": false,
        "description": "Only params visible in the selected model's Params panel are applied.",
        "properties": {
          "guidance_scale": {
            "type": "number"
          },
          "num_inference_steps": {
            "type": "number"
          },
          "seed": {
            "type": "number"
          },
          "safety_tolerance": {
            "type": "string",
            "enum": [
              "1",
              "2",
              "3",
              "4",
              "5",
              "6"
            ]
          },
          "enable_safety_checker": {
            "type": "boolean"
          },
          "lora_url": {
            "type": "string"
          },
          "lora_scale": {
            "type": "number"
          },
          "enable_web_search": {
            "type": "boolean"
          },
          "quality": {
            "type": "string",
            "enum": [
              "auto",
              "low",
              "medium",
              "high"
            ]
          },
          "output_format": {
            "type": "string",
            "enum": [
              "png",
              "webp",
              "jpeg"
            ]
          },
          "background": {
            "type": "string",
            "enum": [
              "auto",
              "transparent",
              "opaque"
            ]
          },
          "category": {
            "type": "string",
            "enum": [
              "tops",
              "bottoms",
              "one-pieces"
            ]
          },
          "mode": {
            "type": "string",
            "enum": [
              "balanced",
              "performance",
              "quality"
            ]
          },
          "cloth_type": {
            "type": "string",
            "enum": [
              "upper",
              "lower",
              "overall"
            ]
          },
          "prompt": {
            "type": "string"
          },
          "creativity": {
            "type": "number"
          },
          "resemblance": {
            "type": "number"
          },
          "scale": {
            "type": "string",
            "enum": [
              "2",
              "4"
            ]
          },
          "steps": {
            "type": "number"
          },
          "tile_diffusion_stride": {
            "type": "number"
          },
          "scale_factor": {
            "type": "string",
            "enum": [
              "2",
              "4"
            ]
          },
          "resolution": {
            "type": "string",
            "enum": [
              "480p",
              "580p",
              "720p",
              "1080p"
            ]
          },
          "generate_audio": {
            "type": "boolean"
          },
          "cfg_scale": {
            "type": "number"
          },
          "negative_prompt": {
            "type": "string"
          },
          "camera_fixed": {
            "type": "boolean"
          },
          "video_quality": {
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high",
              "maximum"
            ]
          },
          "use_turbo": {
            "type": "boolean"
          }
        }
      }
    }
  }
}