AdsTurbo Ad Clone API

openapi: 3.2.0
info:
  title: AdsTurbo Open Ad Clone API
  description: 'AdsTurbo Open API documentation. All endpoints are under `/openapi/v1/`.


    **Base URL**: `https://adsturbo.ai/klian/novartapi`


    **Authentication**: Use **HTTP Bearer** (RFC 6750). Send `Authorization: Bearer `, where `` is the API key created in the AdsTurbo console.


    **Request body**: `Content-Type: application/json`


    **Success response**: HTTP 200 with `{ "ret": 1, "data": { "ent": } }`


    **Business errors**: HTTP 200 may still contain `ret` other than `1`. Read `msg` for the error reason.'
  version: 1.0.0
servers:
- url: https://adsturbo.ai/klian/novartapi
  description: API base URL
security:
- bearerAuth: []
tags:
- name: AdClone
  description: AdClone video recreation
paths:
  /openapi/v1/adclone/analyze:
    post:
      tags:
      - AdClone
      summary: Analyze an ad video
      operationId: openAdCloneAnalyze
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAdCloneAnalyzeBody'
      responses:
        '200':
          description: JSON business response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiSuccessOpenAdCloneAnalyzeEnt'
      description: Analyze a source ad video clip and return a prompt plus a reusable video segment.
  /openapi/v1/adclone/generate:
    post:
      tags:
      - AdClone
      summary: Generate an ad clone video
      operationId: openAdCloneGenerate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAdCloneGenerateBody'
      responses:
        '200':
          description: JSON business response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiSuccessOpenWorkEnt'
      description: Submit an AdClone generation task using a prompt and source video segment.
components:
  schemas:
    OpenWorkData:
      type: object
      description: Async task status and result summary.
      properties:
        workspace_id:
          type: string
        status:
          type: string
          description: pending / processing / completed / failed
        callback_id:
          type: string
          description: Custom tracking ID, echoed back in `/openapi/v1/work/status` results so you can match tasks to your own records (webhook delivery is not available yet).
        result_type:
          type: string
          enum:
          - video
          - image
          - audio
          - text
          - structured
        result_url:
          type: string
        thumbnail_url:
          type: string
        duration:
          type: number
          format: float
        message:
          type: string
        created_at:
          type: integer
          format: int64
    OpenAdCloneGenerateBody:
      type: object
      description: Submit an AdClone generation task. The response contains an async task ID (`workspace_id`).
      properties:
        prompt:
          type: string
          description: Prompt. You can modify the prompt returned by Analyze.
        video_url:
          type: string
          description: Source video segment URL returned by Analyze.
        duration:
          type: integer
          format: int32
          enum:
          - 4
          - 8
          - 12
          - 16
          - 20
          description: Output duration in seconds. Values outside the allowed set (including omitted) fall back to 12.
        ratio:
          type: string
          description: Aspect ratio. Empty = `9:16`.
        callback_id:
          type: string
          description: Custom tracking ID, echoed back in `/openapi/v1/work/status` results so you can match tasks to your own records (webhook delivery is not available yet).
    OpenAdCloneAnalyzeBody:
      type: object
      description: Analyze a source ad video and generate a prompt.
      properties:
        video_url:
          type: string
          description: Source video URL.
        clip_start:
          type: integer
          format: int32
          minimum: 0
          description: Clip start time in seconds. Must be non-negative.
        clip_end:
          type: integer
          format: int32
          minimum: 0
          description: Clip end time in seconds. Must be greater than `clip_start`, with a maximum clip length of 12 seconds.
    OpenAdCloneAnalyzeData:
      type: object
      description: AdClone analysis result.
      properties:
        prompt:
          type: string
          description: Text-to-video prompt generated by AI analysis.
        video_segment_url:
          type: string
          description: Clipped video segment URL.
        duration:
          type: integer
          enum:
          - 4
          - 8
          - 12
          description: 'Clip duration in seconds. Allowed values: 4, 8, or 12.'
    ApiSuccessOpenAdCloneAnalyzeEnt:
      type: object
      required:
      - ret
      properties:
        ret:
          type: integer
          example: 1
        msg:
          type: string
        data:
          type: object
          properties:
            ent:
              $ref: '#/components/schemas/OpenAdCloneAnalyzeData'
    ApiSuccessOpenWorkEnt:
      type: object
      required:
      - ret
      properties:
        ret:
          type: integer
          example: 1
        msg:
          type: string
        data:
          type: object
          properties:
            ent:
              $ref: '#/components/schemas/OpenWorkData'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: '在 [adsturbo.ai](https://adsturbo.ai) 控制台创建的密钥。调用时在请求头设置：`Authorization: Bearer <your_api_key>`。

        '