LovPics AI Reels Ugc API

The ai-reels-ugc API from LovPics — 6 operation(s) for ai-reels-ugc.

GitHub OpenAPI

Operations 6

POST /api/ai-reels/ugc/generate-concepts Ugc Generate Concepts #
POST /api/ai-reels/ugc/generate-concept-storyboard Ugc Generate Concept Storyboard #
POST /api/ai-reels/ugc/generate-voice-script Ugc Generate Voice Script #
POST /api/ai-reels/ugc/generate-storyboard Ugc Generate Storyboard #
POST /api/ai-reels/ugc/generate-reel-stream Ugc Generate Reel Stream #
POST /api/ai-reels/ugc/generate-reel-queue Enqueue a UGC product reel generation job; returns jobId. #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/lovpics-com:lovpics-com-ai-reels-ugc-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lovpics-com-ai-reels-ugc-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Virtual Studio AI Reels Ugc API
  version: 0.1.0
tags:
- name: ai-reels-ugc
paths:
  /api/ai-reels/ugc/generate-concepts:
    post:
      tags:
      - ai-reels-ugc
      summary: Ugc Generate Concepts
      description: Generate a UGC product showcase reel concept.
      operationId: ugc_generate_concepts_api_ai_reels_ugc_generate_concepts_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UgcConceptsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConceptsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/ai-reels/ugc/generate-concept-storyboard:
    post:
      tags:
      - ai-reels-ugc
      summary: Ugc Generate Concept Storyboard
      description: Generate a UGC concept plus storyboard stills (4 credits for storyboard).
      operationId: ugc_generate_concept_storyboard_api_ai_reels_ugc_generate_concept_storyboard_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UgcConceptsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConceptStoryboardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/ai-reels/ugc/generate-voice-script:
    post:
      tags:
      - ai-reels-ugc
      summary: Ugc Generate Voice Script
      description: Generate a UGC voiceover script from product image / website / description.
      operationId: ugc_generate_voice_script_api_ai_reels_ugc_generate_voice_script_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UgcVoiceScriptRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScriptResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/ai-reels/ugc/generate-storyboard:
    post:
      tags:
      - ai-reels-ugc
      summary: Ugc Generate Storyboard
      description: GPT 8-panel color storyboard for UGC showcase (4 credits).
      operationId: ugc_generate_storyboard_api_ai_reels_ugc_generate_storyboard_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UgcStoryboardRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StoryboardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/ai-reels/ugc/generate-reel-stream:
    post:
      tags:
      - ai-reels-ugc
      summary: Ugc Generate Reel Stream
      description: Generate UGC video from pre-generated storyboard(s) via Fal Seedance. NDJSON stream.
      operationId: ugc_generate_reel_stream_api_ai_reels_ugc_generate_reel_stream_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UgcReelRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/ai-reels/ugc/generate-reel-queue:
    post:
      tags:
      - ai-reels-ugc
      summary: Enqueue a UGC product reel generation job; returns jobId.
      description: Queue UGC reel generation; poll GET /api/ai-reels/jobs/{jobId} for status.
      operationId: ugc_generate_reel_queue_api_ai_reels_ugc_generate_reel_queue_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UgcReelRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReelQueueResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
components:
  schemas:
    ScriptResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        script:
          type: string
          title: Script
          examples:
          - Meet the all-new festive collection.
      additionalProperties: true
      type: object
      required:
      - success
      - script
      title: ScriptResponse
    UgcReelRequest:
      properties:
        concept:
          additionalProperties: true
          type: object
          title: Concept
        productImages:
          items:
            type: string
          type: array
          maxItems: 4
          title: Productimages
        creatorModelImage:
          anyOf:
          - type: string
          - type: 'null'
          title: Creatormodelimage
        creatorModelMeta:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Creatormodelmeta
        voiceoverScript:
          anyOf:
          - type: string
          - type: 'null'
          title: Voiceoverscript
        aspectRatio:
          type: string
          title: Aspectratio
          default: '9:16'
        planDurationSeconds:
          type: integer
          title: Plandurationseconds
          default: 15
        videoDuration:
          type: integer
          title: Videoduration
          default: 16
        companyLogo:
          anyOf:
          - type: string
          - type: 'null'
          title: Companylogo
        companyLogoPlacement:
          anyOf:
          - type: string
          - type: 'null'
          title: Companylogoplacement
        companyLogoHeightPx:
          anyOf:
          - type: integer
          - type: 'null'
          title: Companylogoheightpx
        backgroundMusic:
          anyOf:
          - type: string
          - type: 'null'
          title: Backgroundmusic
        outroCompanyLogo:
          anyOf:
          - type: string
          - type: 'null'
          title: Outrocompanylogo
        outroPhone:
          anyOf:
          - type: string
          - type: 'null'
          title: Outrophone
        outroWebsite:
          anyOf:
          - type: string
          - type: 'null'
          title: Outrowebsite
        outroVideo:
          anyOf:
          - type: string
          - type: 'null'
          title: Outrovideo
        storyboardImageUrls:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Storyboardimageurls
        videoQuality:
          type: string
          title: Videoquality
          default: basic
      type: object
      required:
      - concept
      title: UgcReelRequest
    UgcConceptsRequest:
      properties:
        images:
          items:
            type: string
          type: array
          maxItems: 4
          title: Images
        aspectRatio:
          type: string
          title: Aspectratio
          default: '9:16'
        duration:
          type: integer
          title: Duration
          default: 15
        instructions:
          anyOf:
          - type: string
          - type: 'null'
          title: Instructions
        creatorModelImage:
          anyOf:
          - type: string
          - type: 'null'
          title: Creatormodelimage
        creatorModelMeta:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Creatormodelmeta
        voiceoverScript:
          anyOf:
          - type: string
          - type: 'null'
          title: Voiceoverscript
        segmentVoiceoverScripts:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Segmentvoiceoverscripts
      type: object
      title: UgcConceptsRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    StoryboardResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        imageUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Imageurl
          examples:
          - https://…/storyboard.png
        creativeId:
          anyOf:
          - type: integer
          - type: 'null'
          title: Creativeid
          examples:
          - 900
        path:
          anyOf:
          - type: string
          - type: 'null'
          title: Path
          examples:
          - ai-reels/storyboard.png
        storyboardCreditsUsed:
          anyOf:
          - type: integer
          - type: 'null'
          title: Storyboardcreditsused
          examples:
          - 2
        credits_remaining:
          anyOf:
          - type: integer
          - type: 'null'
          title: Credits Remaining
          examples:
          - 240
      additionalProperties: true
      type: object
      required:
      - success
      title: StoryboardResponse
    UgcVoiceScriptRequest:
      properties:
        duration:
          type: integer
          title: Duration
          default: 15
        productImage:
          anyOf:
          - type: string
          - type: 'null'
          title: Productimage
        websiteUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Websiteurl
        productDescription:
          anyOf:
          - type: string
          - type: 'null'
          title: Productdescription
        userProvidedScript:
          type: boolean
          title: Userprovidedscript
          default: false
      type: object
      title: UgcVoiceScriptRequest
    ReelQueueResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        jobId:
          type: integer
          title: Jobid
          examples:
          - 456
        status:
          type: string
          title: Status
          examples:
          - queued
        message:
          type: string
          title: Message
          examples:
          - Reel queued. You can leave this page — we will notify you when it is ready.
      additionalProperties: true
      type: object
      required:
      - success
      - jobId
      - status
      - message
      title: ReelQueueResponse
    UgcStoryboardRequest:
      properties:
        concept:
          additionalProperties: true
          type: object
          title: Concept
        productImages:
          items:
            type: string
          type: array
          maxItems: 4
          title: Productimages
        creatorModelImage:
          anyOf:
          - type: string
          - type: 'null'
          title: Creatormodelimage
        creatorModelMeta:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Creatormodelmeta
        aspectRatio:
          type: string
          title: Aspectratio
          default: '9:16'
        durationSeconds:
          type: integer
          title: Durationseconds
          default: 15
        segmentIndex:
          type: integer
          title: Segmentindex
          default: 0
      type: object
      required:
      - concept
      title: UgcStoryboardRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ConceptStoryboardResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        concept:
          $ref: '#/components/schemas/ReelConcept'
        storyboardImageUrls:
          items:
            type: string
          type: array
          title: Storyboardimageurls
          examples:
          - - https://…/storyboard.png
        storyboardCreditsUsed:
          anyOf:
          - type: integer
          - type: 'null'
          title: Storyboardcreditsused
          examples:
          - 2
        credits_remaining:
          anyOf:
          - type: integer
          - type: 'null'
          title: Credits Remaining
          examples:
          - 240
      additionalProperties: true
      type: object
      required:
      - success
      - concept
      title: ConceptStoryboardResponse
    ReelConcept:
      properties:
        concept_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Concept Id
          examples:
          - 1
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
          examples:
          - Festive lookbook
        summary:
          anyOf:
          - type: string
          - type: 'null'
          title: Summary
          examples:
          - A warm product story told in three beats.
      additionalProperties: true
      type: object
      title: ReelConcept
    ConceptsResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        concepts:
          items:
            $ref: '#/components/schemas/ReelConcept'
          type: array
          title: Concepts
      additionalProperties: true
      type: object
      required:
      - success
      - concepts
      title: ConceptsResponse
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer