> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skills.video/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.0 Fast

Faster Seedance 2.0 variant with the same text/image/frame/reference workflows.


## OpenAPI

````yaml /openapi.json post /generation/bytedance/seedance-2.0/fast
openapi: 3.1.0
info:
  title: skills.video OpenAPI
  version: 1.0.0
  description: OpenAPI schema for skills.video API endpoints.
servers:
  - url: https://open.skills.video/api/v1
security: []
paths:
  /generation/bytedance/seedance-2.0/fast:
    post:
      summary: Seedance 2.0 Fast
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/bytedance_seedance_2_0_fastCreateRequest'
          multipart/form-data:
            schema:
              $ref: >-
                #/components/schemas/bytedance_seedance_2_0_fastMultipartCreateRequest
      responses:
        '200':
          description: Generation submission accepted
          content:
            application/json:
              example:
                id: gen_123
                status: IN_QUEUE
                input:
                  prompt: a cat walking through neon rain
                  duration: 5
                  aspect_ratio: '16:9'
                  'n': 1
                usage:
                  total: 20
                  subscription: 20
                  permanent: 0
              schema:
                $ref: '#/components/schemas/bytedance_seedance_2_0_fastPrediction'
        '400':
          description: >-
            Video generation request was rejected as invalid or model is not
            supported.
          content:
            application/json:
              example:
                error: VIDEO_GENERATION_INVALID_INPUT
                code: VIDEO_GENERATION_INVALID_INPUT
                message: '''prompt'' parameter is required'
              schema:
                anyOf:
                  - $ref: '#/components/schemas/VideoGenerationErrorResponse'
                  - $ref: '#/components/schemas/TemplateErrorResponse'
                  - $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication required or failed
          content:
            application/json:
              example:
                error: UNAUTHORIZED
                code: UNAUTHORIZED
                message: Unauthorized
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '402':
          description: Workspace does not have enough credits to run this generation.
          content:
            application/json:
              example:
                error: INSUFFICIENT_CREDITS
                code: VIDEO_GENERATION_INSUFFICIENT_CREDITS
                message: Insufficient credits for this generation.
              schema:
                $ref: '#/components/schemas/VideoGenerationErrorResponse'
        '403':
          description: Workspace access is forbidden or Seedance verification is required.
          content:
            application/json:
              example:
                error: WORKSPACE_FORBIDDEN
                code: WORKSPACE_FORBIDDEN
                message: You do not have access to this workspace.
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ErrorResponse'
                  - $ref: '#/components/schemas/SeedanceVerificationErrorResponse'
        '404':
          description: Resource, model, or template not found.
          content:
            application/json:
              example:
                error: TEMPLATE_NOT_FOUND
                code: TEMPLATE_NOT_FOUND
                message: Template not found.
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ErrorResponse'
                  - $ref: '#/components/schemas/TemplateErrorResponse'
        '422':
          description: Upstream moderation rejected the request content.
          content:
            application/json:
              example:
                error: VIDEO_GENERATION_CONTENT_REJECTED
                code: VIDEO_GENERATION_CONTENT_REJECTED
                message: Request content was rejected by the moderation policy.
              schema:
                $ref: '#/components/schemas/VideoGenerationErrorResponse'
        '429':
          description: Generation rate limit exceeded upstream.
          content:
            application/json:
              example:
                error: VIDEO_GENERATION_RATE_LIMITED
                code: VIDEO_GENERATION_RATE_LIMITED
                message: Rate limit exceeded. Please retry later.
              schema:
                $ref: '#/components/schemas/VideoGenerationErrorResponse'
        '500':
          description: >-
            Video generation failed before provider execution completed.
            Response includes code and message fields.
          content:
            application/json:
              example:
                error: VIDEO_GENERATION_FAILED
                code: VIDEO_GENERATION_FAILED
                message: Generation failed.
              schema:
                anyOf:
                  - $ref: '#/components/schemas/VideoGenerationErrorResponse'
                  - $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: >-
            Video generation failed. Returned when the upstream provider reports
            a generic failure.
          content:
            application/json:
              example:
                error: VIDEO_GENERATION_FAILED
                code: VIDEO_GENERATION_FAILED
                message: Generation failed.
              schema:
                $ref: '#/components/schemas/VideoGenerationErrorResponse'
        '503':
          description: Upstream generation provider is unavailable.
          content:
            application/json:
              example:
                error: VIDEO_GENERATION_PROVIDER_UNAVAILABLE
                code: VIDEO_GENERATION_PROVIDER_UNAVAILABLE
                message: Upstream generation provider is temporarily unavailable.
              schema:
                $ref: '#/components/schemas/VideoGenerationErrorResponse'
        '504':
          description: Video generation exceeded the upstream timeout.
          content:
            application/json:
              example:
                error: VIDEO_GENERATION_TIMEOUT
                code: VIDEO_GENERATION_TIMEOUT
                message: Generation timed out.
              schema:
                $ref: '#/components/schemas/VideoGenerationErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    bytedance_seedance_2_0_fastCreateRequest:
      $ref: '#/components/schemas/bytedance_seedance_2_0_fastInput'
      title: Input
    bytedance_seedance_2_0_fastMultipartCreateRequest:
      title: Input
      allOf:
        - title: Input
          type: object
          properties:
            feature:
              description: >-
                Workflow type: text/image-to-video, frame-to-video, or
                reference-to-video.
              title: Feature
              default: text-image-to-video
              type: string
              enum:
                - text-image-to-video
                - frame-to-video
                - reference-to-video
            prompt:
              description: The text prompt used to generate the video
              title: Prompt
              type: string
            aspect_ratio:
              description: The aspect ratio of the generated video
              title: aspect_ratio
              default: '16:9'
              type: string
              enum:
                - '21:9'
                - '16:9'
                - '4:3'
                - '1:1'
                - '3:4'
                - '9:16'
            resolution:
              description: Video resolution
              title: resolution
              default: 720p
              type: string
              enum:
                - 480p
                - 720p
            duration:
              description: Video duration in seconds
              title: Duration
              default: 5
              type: integer
              minimum: 4
              maximum: 15
            generate_audio:
              description: Whether to generate native audio for the video
              title: Generate Audio
              default: true
              type: boolean
            seed:
              description: Random seed for reproducible generation
              title: Seed
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
            end_user_id:
              description: Unique user identifier for safety and monitoring.
              title: End User ID
              type: string
            audio_url:
              description: >-
                Single audio reference URL (compatibility alias). When using
                application/json, send a public URL. When using
                multipart/form-data, send either a public URL or a binary file
                upload.
              title: Audio URL
              xMeta:
                allowedAudioExtensions:
                  - mp3
                  - wav
                combinedDurationRange:
                  min: 0
                  max: 15
                maxSizeBytesPerFile: 15728640
                requireReferenceMediaWhenPresent: true
              x-cli-aliases:
                - audio
              anyOf:
                - format: uri
                  type: string
                - format: binary
                  type: string
            audio_urls:
              description: Reference audio URLs for reference-to-video mode (max 3).
              title: Audio URLs
              xMeta:
                allowedAudioExtensions:
                  - mp3
                  - wav
                combinedDurationRange:
                  min: 0
                  max: 15
                maxSizeBytesPerFile: 15728640
                requireReferenceMediaWhenPresent: true
              x-cli-aliases:
                - audio
                - audios
              maxItems: 3
              type: array
              items:
                description: >-
                  When using application/json, send a public URL. When using
                  multipart/form-data, send either a public URL or a binary file
                  upload.
                anyOf:
                  - format: uri
                    type: string
                  - format: binary
                    type: string
            image_url:
              description: >-
                Optional source image URL for text/image-to-video mode. When
                using application/json, send a public URL. When using
                multipart/form-data, send either a public URL or a binary file
                upload.
              title: Image URL
              x-cli-aliases:
                - image
              anyOf:
                - format: uri
                  type: string
                - format: binary
                  type: string
            image_urls:
              description: >-
                Image URLs for reference-to-video mode (max 9).
                text/image-to-video supports at most 1 image.
              title: Image URLs
              x-cli-aliases:
                - image
                - images
              maxItems: 9
              type: array
              items:
                description: >-
                  When using application/json, send a public URL. When using
                  multipart/form-data, send either a public URL or a binary file
                  upload.
                anyOf:
                  - format: uri
                    type: string
                  - format: binary
                    type: string
            reference_image_urls:
              description: Reference image URLs (compatibility alias, max 9).
              title: Reference Image URLs
              x-cli-aliases:
                - reference-image
                - reference-images
              maxItems: 9
              type: array
              items:
                description: >-
                  When using application/json, send a public URL. When using
                  multipart/form-data, send either a public URL or a binary file
                  upload.
                anyOf:
                  - format: uri
                    type: string
                  - format: binary
                    type: string
            video_urls:
              description: Reference video URLs for reference-to-video mode (max 3).
              title: Video URLs
              xMeta:
                allowedVideoExtensions:
                  - mp4
                  - mov
                combinedDurationRange:
                  min: 2
                  max: 15
                totalSizeBytesMax: 52428800
                videoTotalPixelsRange:
                  min: 409600
                  max: 927408
              x-cli-aliases:
                - video
                - videos
              maxItems: 3
              type: array
              items:
                description: >-
                  When using application/json, send a public URL. When using
                  multipart/form-data, send either a public URL or a binary file
                  upload.
                anyOf:
                  - format: uri
                    type: string
                  - format: binary
                    type: string
            video_refs:
              description: Reference video URLs (compatibility alias, max 3).
              title: Reference Video URLs
              xMeta:
                allowedVideoExtensions:
                  - mp4
                  - mov
                combinedDurationRange:
                  min: 2
                  max: 15
                totalSizeBytesMax: 52428800
                videoTotalPixelsRange:
                  min: 409600
                  max: 927408
              maxItems: 3
              type: array
              items:
                description: >-
                  When using application/json, send a public URL. When using
                  multipart/form-data, send either a public URL or a binary file
                  upload.
                anyOf:
                  - format: uri
                    type: string
                  - format: binary
                    type: string
            first_frame_url:
              description: >-
                First frame image URL for frame-to-video mode. When using
                application/json, send a public URL. When using
                multipart/form-data, send either a public URL or a binary file
                upload.
              title: First Frame URL
              x-cli-aliases:
                - first-frame
                - start-frame
              anyOf:
                - format: uri
                  type: string
                - format: binary
                  type: string
            end_frame_url:
              description: >-
                Optional end frame image URL for frame-to-video mode. When using
                application/json, send a public URL. When using
                multipart/form-data, send either a public URL or a binary file
                upload.
              title: End Frame URL
              x-cli-aliases:
                - end-frame
                - last-frame
              anyOf:
                - format: uri
                  type: string
                - format: binary
                  type: string
          required:
            - prompt
          additionalProperties: {}
        - anyOf:
            - title: Text/Image
              type: object
              properties:
                feature:
                  type: string
                  enum:
                    - text-image-to-video
                image_url:
                  x-cli-aliases:
                    - image
                prompt: {}
              required:
                - prompt
              additionalProperties: {}
            - title: Frame
              type: object
              properties:
                feature:
                  type: string
                  enum:
                    - frame-to-video
                first_frame_url:
                  x-cli-aliases:
                    - first-frame
                    - start-frame
                end_frame_url:
                  x-cli-aliases:
                    - end-frame
                    - last-frame
                prompt: {}
              required:
                - first_frame_url
                - prompt
              additionalProperties: {}
            - title: Reference
              type: object
              properties:
                feature:
                  type: string
                  enum:
                    - reference-to-video
                image_urls:
                  x-cli-aliases:
                    - image
                    - images
                  maxItems: 9
                  type: array
                  items:
                    description: >-
                      When using application/json, send a public URL. When using
                      multipart/form-data, send either a public URL or a binary
                      file upload.
                    anyOf:
                      - format: uri
                        type: string
                      - format: binary
                        type: string
                reference_image_urls:
                  x-cli-aliases:
                    - reference-image
                    - reference-images
                  maxItems: 9
                  type: array
                  items:
                    description: >-
                      When using application/json, send a public URL. When using
                      multipart/form-data, send either a public URL or a binary
                      file upload.
                    anyOf:
                      - format: uri
                        type: string
                      - format: binary
                        type: string
                video_urls:
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  x-cli-aliases:
                    - video
                    - videos
                  maxItems: 3
                  type: array
                  items:
                    description: >-
                      When using application/json, send a public URL. When using
                      multipart/form-data, send either a public URL or a binary
                      file upload.
                    anyOf:
                      - format: uri
                        type: string
                      - format: binary
                        type: string
                video_refs:
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    description: >-
                      When using application/json, send a public URL. When using
                      multipart/form-data, send either a public URL or a binary
                      file upload.
                    anyOf:
                      - format: uri
                        type: string
                      - format: binary
                        type: string
                audio_url:
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  x-cli-aliases:
                    - audio
                audio_urls:
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  x-cli-aliases:
                    - audio
                    - audios
                  maxItems: 3
                  type: array
                  items:
                    description: >-
                      When using application/json, send a public URL. When using
                      multipart/form-data, send either a public URL or a binary
                      file upload.
                    anyOf:
                      - format: uri
                        type: string
                      - format: binary
                        type: string
                prompt: {}
              required:
                - prompt
              additionalProperties: {}
    bytedance_seedance_2_0_fastPrediction:
      type: object
      properties:
        id:
          description: Generation id.
          type: string
        status:
          $ref: '#/components/schemas/QueueState'
        input:
          $ref: '#/components/schemas/bytedance_seedance_2_0_fastInputOutput'
          title: Input
          description: Normalized input payload for the generation task.
        usage:
          $ref: '#/components/schemas/Usage'
        code:
          $ref: '#/components/schemas/__schema1'
        message:
          $ref: '#/components/schemas/__schema2'
      required:
        - id
        - status
        - input
        - usage
      additionalProperties: false
    VideoGenerationErrorResponse:
      type: object
      properties:
        error:
          description: >-
            Legacy machine-readable error field. Prefer `code` for new
            integrations.
          type: string
        code:
          description: >-
            Video generation error code. `*_FAILED` is the generic fallback;
            more specific codes (`*_TIMEOUT`, `*_RATE_LIMITED`,
            `*_PROVIDER_UNAVAILABLE`, `*_UNSUPPORTED_MODEL`, `*_INVALID_INPUT`,
            `*_INSUFFICIENT_CREDITS`, `*_CONTENT_REJECTED`) are surfaced when
            applicable.
          type: string
          enum:
            - VIDEO_GENERATION_FAILED
            - VIDEO_GENERATION_TIMEOUT
            - VIDEO_GENERATION_RATE_LIMITED
            - VIDEO_GENERATION_PROVIDER_UNAVAILABLE
            - VIDEO_GENERATION_UNSUPPORTED_MODEL
            - VIDEO_GENERATION_INVALID_INPUT
            - VIDEO_GENERATION_INSUFFICIENT_CREDITS
            - VIDEO_GENERATION_CONTENT_REJECTED
        message:
          description: Human readable error message. Upstream vendor names are redacted.
          type: string
        errors:
          description: Field-level validation errors when available.
          type: array
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
              code:
                type: string
            required:
              - path
              - message
              - code
            additionalProperties: false
        details:
          description: Additional structured error details when available.
        requested:
          description: Requested credits when the error is insufficient credits.
          type: number
        available:
          description: Available credits when the error is insufficient credits.
          type: number
      required:
        - code
        - message
      additionalProperties: false
    TemplateErrorResponse:
      type: object
      properties:
        error:
          description: >-
            Legacy machine-readable error field. Prefer `code` for new
            integrations.
          type: string
        code:
          description: Template error code.
          type: string
          enum:
            - TEMPLATE_NOT_FOUND
            - TEMPLATE_MODEL_MISMATCH
            - TEMPLATE_INVALID_INPUT
            - TEMPLATE_TRANSFORM_FAILED
        message:
          description: Human readable template error message.
          type: string
        errors:
          description: Field-level template validation errors when available.
          type: array
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
              code:
                type: string
            required:
              - path
              - message
              - code
            additionalProperties: false
        details:
          description: Additional structured error details when available.
      required:
        - code
        - message
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        error:
          description: >-
            Legacy machine-readable error field. Prefer `code` for new
            integrations. This may contain an unprefixed compatibility code for
            older clients.
          type: string
        code:
          description: Machine-readable error code. Use this to branch in client code.
          type: string
        message:
          description: Human readable error message.
          type: string
        errors:
          description: Field-level validation errors when available.
          type: array
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
              code:
                type: string
            required:
              - path
              - message
              - code
            additionalProperties: false
        details:
          description: Additional structured error details when available.
      required:
        - code
        - message
      additionalProperties: false
    SeedanceVerificationErrorResponse:
      type: object
      properties:
        error:
          description: >-
            Legacy machine-readable error field. Prefer `code` for new
            integrations.
          type: string
        code:
          description: Seedance verification error code.
          type: string
          const: SEEDANCE_VERIFICATION_REQUIRED
        message:
          description: Human readable verification error message.
          type: string
        verification:
          description: Current Seedance verification state when available.
          anyOf:
            - {}
            - type: 'null'
      required:
        - code
        - message
      additionalProperties: false
    bytedance_seedance_2_0_fastInput:
      title: Input
      oneOf:
        - title: Text Image To Video
          allOf:
            - title: Input
              type: object
              properties:
                feature:
                  description: >-
                    Workflow type: text/image-to-video, frame-to-video, or
                    reference-to-video.
                  title: Feature
                  type: string
                  const: text-image-to-video
                prompt:
                  description: The text prompt used to generate the video
                  title: Prompt
                  type: string
                aspect_ratio:
                  description: The aspect ratio of the generated video
                  title: aspect_ratio
                  default: '16:9'
                  type: string
                  enum:
                    - '21:9'
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                resolution:
                  description: Video resolution
                  title: resolution
                  default: 720p
                  type: string
                  enum:
                    - 480p
                    - 720p
                duration:
                  description: Video duration in seconds
                  title: Duration
                  default: 5
                  type: integer
                  minimum: 4
                  maximum: 15
                generate_audio:
                  description: Whether to generate native audio for the video
                  title: Generate Audio
                  default: true
                  type: boolean
                seed:
                  description: Random seed for reproducible generation
                  title: Seed
                  type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                end_user_id:
                  description: Unique user identifier for safety and monitoring.
                  title: End User ID
                  type: string
                audio_url:
                  description: Single audio reference URL (compatibility alias).
                  title: Audio URL
                  format: uri
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  type: string
                audio_urls:
                  description: Reference audio URLs for reference-to-video mode (max 3).
                  title: Audio URLs
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                image_url:
                  description: Optional source image URL for text/image-to-video mode.
                  title: Image URL
                  format: uri
                  type: string
                image_urls:
                  description: >-
                    Image URLs for reference-to-video mode (max 9).
                    text/image-to-video supports at most 1 image.
                  title: Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                reference_image_urls:
                  description: Reference image URLs (compatibility alias, max 9).
                  title: Reference Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                video_urls:
                  description: Reference video URLs for reference-to-video mode (max 3).
                  title: Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                video_refs:
                  description: Reference video URLs (compatibility alias, max 3).
                  title: Reference Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                first_frame_url:
                  description: First frame image URL for frame-to-video mode.
                  title: First Frame URL
                  format: uri
                  type: string
                end_frame_url:
                  description: Optional end frame image URL for frame-to-video mode.
                  title: End Frame URL
                  format: uri
                  type: string
              required:
                - prompt
              additionalProperties: {}
            - title: Text/Image
              type: object
              properties:
                feature:
                  type: string
                  const: text-image-to-video
                image_url: {}
                prompt: {}
              required:
                - prompt
              additionalProperties: {}
        - title: Frame To Video
          allOf:
            - title: Input
              type: object
              properties:
                feature:
                  description: >-
                    Workflow type: text/image-to-video, frame-to-video, or
                    reference-to-video.
                  title: Feature
                  type: string
                  const: frame-to-video
                prompt:
                  description: The text prompt used to generate the video
                  title: Prompt
                  type: string
                aspect_ratio:
                  description: The aspect ratio of the generated video
                  title: aspect_ratio
                  default: '16:9'
                  type: string
                  enum:
                    - '21:9'
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                resolution:
                  description: Video resolution
                  title: resolution
                  default: 720p
                  type: string
                  enum:
                    - 480p
                    - 720p
                duration:
                  description: Video duration in seconds
                  title: Duration
                  default: 5
                  type: integer
                  minimum: 4
                  maximum: 15
                generate_audio:
                  description: Whether to generate native audio for the video
                  title: Generate Audio
                  default: true
                  type: boolean
                seed:
                  description: Random seed for reproducible generation
                  title: Seed
                  type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                end_user_id:
                  description: Unique user identifier for safety and monitoring.
                  title: End User ID
                  type: string
                audio_url:
                  description: Single audio reference URL (compatibility alias).
                  title: Audio URL
                  format: uri
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  type: string
                audio_urls:
                  description: Reference audio URLs for reference-to-video mode (max 3).
                  title: Audio URLs
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                image_url:
                  description: Optional source image URL for text/image-to-video mode.
                  title: Image URL
                  format: uri
                  type: string
                image_urls:
                  description: >-
                    Image URLs for reference-to-video mode (max 9).
                    text/image-to-video supports at most 1 image.
                  title: Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                reference_image_urls:
                  description: Reference image URLs (compatibility alias, max 9).
                  title: Reference Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                video_urls:
                  description: Reference video URLs for reference-to-video mode (max 3).
                  title: Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                video_refs:
                  description: Reference video URLs (compatibility alias, max 3).
                  title: Reference Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                first_frame_url:
                  description: First frame image URL for frame-to-video mode.
                  title: First Frame URL
                  format: uri
                  type: string
                end_frame_url:
                  description: Optional end frame image URL for frame-to-video mode.
                  title: End Frame URL
                  format: uri
                  type: string
              required:
                - prompt
              additionalProperties: {}
            - title: Frame
              type: object
              properties:
                feature:
                  type: string
                  const: frame-to-video
                first_frame_url: {}
                end_frame_url: {}
                prompt: {}
              required:
                - first_frame_url
                - prompt
              additionalProperties: {}
        - title: Reference To Video
          allOf:
            - title: Input
              type: object
              properties:
                feature:
                  description: >-
                    Workflow type: text/image-to-video, frame-to-video, or
                    reference-to-video.
                  title: Feature
                  type: string
                  const: reference-to-video
                prompt:
                  description: The text prompt used to generate the video
                  title: Prompt
                  type: string
                aspect_ratio:
                  description: The aspect ratio of the generated video
                  title: aspect_ratio
                  default: '16:9'
                  type: string
                  enum:
                    - '21:9'
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                resolution:
                  description: Video resolution
                  title: resolution
                  default: 720p
                  type: string
                  enum:
                    - 480p
                    - 720p
                duration:
                  description: Video duration in seconds
                  title: Duration
                  default: 5
                  type: integer
                  minimum: 4
                  maximum: 15
                generate_audio:
                  description: Whether to generate native audio for the video
                  title: Generate Audio
                  default: true
                  type: boolean
                seed:
                  description: Random seed for reproducible generation
                  title: Seed
                  type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                end_user_id:
                  description: Unique user identifier for safety and monitoring.
                  title: End User ID
                  type: string
                audio_url:
                  description: Single audio reference URL (compatibility alias).
                  title: Audio URL
                  format: uri
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  type: string
                audio_urls:
                  description: Reference audio URLs for reference-to-video mode (max 3).
                  title: Audio URLs
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                image_url:
                  description: Optional source image URL for text/image-to-video mode.
                  title: Image URL
                  format: uri
                  type: string
                image_urls:
                  description: >-
                    Image URLs for reference-to-video mode (max 9).
                    text/image-to-video supports at most 1 image.
                  title: Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                reference_image_urls:
                  description: Reference image URLs (compatibility alias, max 9).
                  title: Reference Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                video_urls:
                  description: Reference video URLs for reference-to-video mode (max 3).
                  title: Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                video_refs:
                  description: Reference video URLs (compatibility alias, max 3).
                  title: Reference Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                first_frame_url:
                  description: First frame image URL for frame-to-video mode.
                  title: First Frame URL
                  format: uri
                  type: string
                end_frame_url:
                  description: Optional end frame image URL for frame-to-video mode.
                  title: End Frame URL
                  format: uri
                  type: string
              required:
                - prompt
              additionalProperties: {}
            - title: Reference
              type: object
              properties:
                feature:
                  type: string
                  const: reference-to-video
                image_urls:
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                reference_image_urls:
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                video_urls:
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                video_refs:
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                audio_url:
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                audio_urls:
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                prompt: {}
              required:
                - prompt
              additionalProperties: {}
    QueueState:
      description: Queue status
      type: string
      enum:
        - IN_QUEUE
        - IN_PROGRESS
        - COMPLETED
        - FAILED
        - CANCELED
    bytedance_seedance_2_0_fastInputOutput:
      $ref: '#/components/schemas/__schema0'
      title: Input
    Usage:
      description: Credit usage breakdown for the request
      type: object
      properties:
        total:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        subscription:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        permanent:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
      required:
        - total
        - subscription
        - permanent
      additionalProperties: false
    __schema1:
      description: >-
        Machine-readable generation error code. Present when `status` is
        `FAILED`.
      type: string
    __schema2:
      description: >-
        Sanitized human-readable failure message. Present when `status` is
        `FAILED`.
      type: string
    __schema0:
      title: Input
      oneOf:
        - title: Text Image To Video
          allOf:
            - title: Input
              type: object
              properties:
                feature:
                  description: >-
                    Workflow type: text/image-to-video, frame-to-video, or
                    reference-to-video.
                  title: Feature
                  type: string
                  const: text-image-to-video
                prompt:
                  description: The text prompt used to generate the video
                  title: Prompt
                  type: string
                aspect_ratio:
                  description: The aspect ratio of the generated video
                  title: aspect_ratio
                  default: '16:9'
                  type: string
                  enum:
                    - '21:9'
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                resolution:
                  description: Video resolution
                  title: resolution
                  default: 720p
                  type: string
                  enum:
                    - 480p
                    - 720p
                duration:
                  description: Video duration in seconds
                  title: Duration
                  default: 5
                  type: integer
                  minimum: 4
                  maximum: 15
                generate_audio:
                  description: Whether to generate native audio for the video
                  title: Generate Audio
                  default: true
                  type: boolean
                seed:
                  description: Random seed for reproducible generation
                  title: Seed
                  type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                end_user_id:
                  description: Unique user identifier for safety and monitoring.
                  title: End User ID
                  type: string
                audio_url:
                  description: Single audio reference URL (compatibility alias).
                  title: Audio URL
                  format: uri
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  type: string
                audio_urls:
                  description: Reference audio URLs for reference-to-video mode (max 3).
                  title: Audio URLs
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                image_url:
                  description: Optional source image URL for text/image-to-video mode.
                  title: Image URL
                  format: uri
                  type: string
                image_urls:
                  description: >-
                    Image URLs for reference-to-video mode (max 9).
                    text/image-to-video supports at most 1 image.
                  title: Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                reference_image_urls:
                  description: Reference image URLs (compatibility alias, max 9).
                  title: Reference Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                video_urls:
                  description: Reference video URLs for reference-to-video mode (max 3).
                  title: Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                video_refs:
                  description: Reference video URLs (compatibility alias, max 3).
                  title: Reference Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                first_frame_url:
                  description: First frame image URL for frame-to-video mode.
                  title: First Frame URL
                  format: uri
                  type: string
                end_frame_url:
                  description: Optional end frame image URL for frame-to-video mode.
                  title: End Frame URL
                  format: uri
                  type: string
              required:
                - prompt
              additionalProperties: {}
            - title: Text/Image
              type: object
              properties:
                feature:
                  type: string
                  const: text-image-to-video
                image_url: {}
                prompt: {}
              required:
                - prompt
              additionalProperties: {}
        - title: Frame To Video
          allOf:
            - title: Input
              type: object
              properties:
                feature:
                  description: >-
                    Workflow type: text/image-to-video, frame-to-video, or
                    reference-to-video.
                  title: Feature
                  type: string
                  const: frame-to-video
                prompt:
                  description: The text prompt used to generate the video
                  title: Prompt
                  type: string
                aspect_ratio:
                  description: The aspect ratio of the generated video
                  title: aspect_ratio
                  default: '16:9'
                  type: string
                  enum:
                    - '21:9'
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                resolution:
                  description: Video resolution
                  title: resolution
                  default: 720p
                  type: string
                  enum:
                    - 480p
                    - 720p
                duration:
                  description: Video duration in seconds
                  title: Duration
                  default: 5
                  type: integer
                  minimum: 4
                  maximum: 15
                generate_audio:
                  description: Whether to generate native audio for the video
                  title: Generate Audio
                  default: true
                  type: boolean
                seed:
                  description: Random seed for reproducible generation
                  title: Seed
                  type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                end_user_id:
                  description: Unique user identifier for safety and monitoring.
                  title: End User ID
                  type: string
                audio_url:
                  description: Single audio reference URL (compatibility alias).
                  title: Audio URL
                  format: uri
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  type: string
                audio_urls:
                  description: Reference audio URLs for reference-to-video mode (max 3).
                  title: Audio URLs
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                image_url:
                  description: Optional source image URL for text/image-to-video mode.
                  title: Image URL
                  format: uri
                  type: string
                image_urls:
                  description: >-
                    Image URLs for reference-to-video mode (max 9).
                    text/image-to-video supports at most 1 image.
                  title: Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                reference_image_urls:
                  description: Reference image URLs (compatibility alias, max 9).
                  title: Reference Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                video_urls:
                  description: Reference video URLs for reference-to-video mode (max 3).
                  title: Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                video_refs:
                  description: Reference video URLs (compatibility alias, max 3).
                  title: Reference Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                first_frame_url:
                  description: First frame image URL for frame-to-video mode.
                  title: First Frame URL
                  format: uri
                  type: string
                end_frame_url:
                  description: Optional end frame image URL for frame-to-video mode.
                  title: End Frame URL
                  format: uri
                  type: string
              required:
                - prompt
              additionalProperties: {}
            - title: Frame
              type: object
              properties:
                feature:
                  type: string
                  const: frame-to-video
                first_frame_url: {}
                end_frame_url: {}
                prompt: {}
              required:
                - first_frame_url
                - prompt
              additionalProperties: {}
        - title: Reference To Video
          allOf:
            - title: Input
              type: object
              properties:
                feature:
                  description: >-
                    Workflow type: text/image-to-video, frame-to-video, or
                    reference-to-video.
                  title: Feature
                  type: string
                  const: reference-to-video
                prompt:
                  description: The text prompt used to generate the video
                  title: Prompt
                  type: string
                aspect_ratio:
                  description: The aspect ratio of the generated video
                  title: aspect_ratio
                  default: '16:9'
                  type: string
                  enum:
                    - '21:9'
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                resolution:
                  description: Video resolution
                  title: resolution
                  default: 720p
                  type: string
                  enum:
                    - 480p
                    - 720p
                duration:
                  description: Video duration in seconds
                  title: Duration
                  default: 5
                  type: integer
                  minimum: 4
                  maximum: 15
                generate_audio:
                  description: Whether to generate native audio for the video
                  title: Generate Audio
                  default: true
                  type: boolean
                seed:
                  description: Random seed for reproducible generation
                  title: Seed
                  type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                end_user_id:
                  description: Unique user identifier for safety and monitoring.
                  title: End User ID
                  type: string
                audio_url:
                  description: Single audio reference URL (compatibility alias).
                  title: Audio URL
                  format: uri
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  type: string
                audio_urls:
                  description: Reference audio URLs for reference-to-video mode (max 3).
                  title: Audio URLs
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                image_url:
                  description: Optional source image URL for text/image-to-video mode.
                  title: Image URL
                  format: uri
                  type: string
                image_urls:
                  description: >-
                    Image URLs for reference-to-video mode (max 9).
                    text/image-to-video supports at most 1 image.
                  title: Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                reference_image_urls:
                  description: Reference image URLs (compatibility alias, max 9).
                  title: Reference Image URLs
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                video_urls:
                  description: Reference video URLs for reference-to-video mode (max 3).
                  title: Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                video_refs:
                  description: Reference video URLs (compatibility alias, max 3).
                  title: Reference Video URLs
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                first_frame_url:
                  description: First frame image URL for frame-to-video mode.
                  title: First Frame URL
                  format: uri
                  type: string
                end_frame_url:
                  description: Optional end frame image URL for frame-to-video mode.
                  title: End Frame URL
                  format: uri
                  type: string
              required:
                - prompt
              additionalProperties: {}
            - title: Reference
              type: object
              properties:
                feature:
                  type: string
                  const: reference-to-video
                image_urls:
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                reference_image_urls:
                  maxItems: 9
                  type: array
                  items:
                    format: uri
                    type: string
                video_urls:
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                video_refs:
                  xMeta:
                    allowedVideoExtensions:
                      - mp4
                      - mov
                    combinedDurationRange:
                      min: 2
                      max: 15
                    totalSizeBytesMax: 52428800
                    videoTotalPixelsRange:
                      min: 409600
                      max: 927408
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                audio_url:
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                audio_urls:
                  xMeta:
                    allowedAudioExtensions:
                      - mp3
                      - wav
                    combinedDurationRange:
                      min: 0
                      max: 15
                    maxSizeBytesPerFile: 15728640
                    requireReferenceMediaWhenPresent: true
                  maxItems: 3
                  type: array
                  items:
                    format: uri
                    type: string
                prompt: {}
              required:
                - prompt
              additionalProperties: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API Key for API endpoints

````