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

# Create Volcengine-format video generation task

> Interface description: Volcengine Ark video generation compatible endpoint for customers who have already integrated the Volcengine video generation API and want to migrate to AiToEarn without significantly changing their request structure. The request body keeps the Volcengine format; replace the request URL with the AiToEarn URL and change authentication to `X-Api-Key`. See the official Volcengine documentation: [Create video generation task](https://www.volcengine.com/docs/82379/1520757?lang=zh).



## OpenAPI

````yaml /openapi/en/aitoearn.openapi.json post /api/ai/volcengine/video
openapi: 3.0.1
info:
  title: AiToEarn Open Platform API
  description: >-
    AiToEarn Open Platform API. You can switch between the China and
    international sites for testing. Business success is determined by whether
    the response body has code === 0.
  version: 1.0.0
  contact: {}
servers:
  - url: https://aitoearn.cn
    description: China site
  - url: https://aitoearn.ai
    description: International site
security: []
tags:
  - name: AI Services
  - name: AI Services/Video Generation
  - name: AI Services/Image Generation
  - name: Channel Management
  - name: Channel Management/Accounts
  - name: Channel Management/Publishing
  - name: Channel Management/Platforms
  - name: Channel Management/Works
  - name: Channel Management/Account Groups
  - name: Channel Management/Authorization
  - name: Asset Management
  - name: AI Services/Large Language Models
paths:
  /api/ai/volcengine/video:
    post:
      tags:
        - AI Services/Video Generation
      summary: Create Volcengine-format video generation task
      description: >-
        Interface description: Volcengine Ark video generation compatible
        endpoint for customers who have already integrated the Volcengine video
        generation API and want to migrate to AiToEarn without significantly
        changing their request structure. The request body keeps the Volcengine
        format; replace the request URL with the AiToEarn URL and change
        authentication to `X-Api-Key`. See the official Volcengine
        documentation: [Create video generation
        task](https://www.volcengine.com/docs/82379/1520757?lang=zh).
      operationId: VolcengineVideoController_videoGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  description: Model ID or Endpoint ID.
                content:
                  type: array
                  description: >-
                    Content passed to the model to generate video, keeping the
                    Volcengine Ark video generation format.
                  items:
                    oneOf:
                      - type: object
                        properties:
                          type:
                            type: string
                            enum:
                              - text
                            description: Content type. Text content is fixed to text.
                          text:
                            type: string
                            description: >-
                              Text prompt used to describe the expected
                              generated video.
                        required:
                          - type
                          - text
                        additionalProperties: false
                      - type: object
                        properties:
                          type:
                            type: string
                            enum:
                              - image_url
                            description: Content type. Image content is fixed to image_url.
                          image_url:
                            type: object
                            properties:
                              url:
                                type: string
                                description: Image URL or base64 image data.
                            required:
                              - url
                            additionalProperties: false
                          role:
                            type: string
                            enum:
                              - first_frame
                              - last_frame
                              - reference_image
                            description: >-
                              Image role: first frame, last frame, or reference
                              image.
                        required:
                          - type
                          - image_url
                        additionalProperties: false
                      - type: object
                        properties:
                          type:
                            type: string
                            enum:
                              - video_url
                            description: Content type. Video content is fixed to video_url.
                          video_url:
                            type: object
                            properties:
                              url:
                                type: string
                                description: Reference video URL or asset ID.
                            required:
                              - url
                            additionalProperties: false
                          role:
                            type: string
                            enum:
                              - reference_video
                            description: Video role. Currently fixed to reference_video.
                        required:
                          - type
                          - video_url
                          - role
                        additionalProperties: false
                      - type: object
                        properties:
                          type:
                            type: string
                            enum:
                              - audio_url
                            description: Content type. Audio content is fixed to audio_url.
                          audio_url:
                            type: object
                            properties:
                              url:
                                type: string
                                description: >-
                                  Reference audio URL, base64 audio data, or
                                  asset ID.
                            required:
                              - url
                            additionalProperties: false
                          role:
                            type: string
                            enum:
                              - reference_audio
                            description: Audio role. Currently fixed to reference_audio.
                        required:
                          - type
                          - audio_url
                          - role
                        additionalProperties: false
                return_last_frame:
                  type: boolean
                  description: Whether to return the last frame image.
                tools:
                  type: array
                  description: Model tool configuration.
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - web_search
                        description: Tool type.
                    required:
                      - type
                    additionalProperties: false
                resolution:
                  type: string
                  description: Resolution.
                ratio:
                  type: string
                  description: Aspect ratio.
                duration:
                  type: integer
                  description: Duration in seconds.
                seed:
                  type: integer
                  description: Random seed.
                watermark:
                  type: boolean
                  description: Whether to include a watermark.
                generate_audio:
                  type: boolean
                  description: >-
                    Whether to generate audio synchronized with the visuals.
                    Supported by the Seedance 2.0 series.
                execution_expires_after:
                  type: integer
                  minimum: 3600
                  maximum: 259200
                  description: >-
                    Task timeout threshold in seconds. Value range: [3600,
                    259200].
                priority:
                  type: integer
                  minimum: 0
                  maximum: 9
                  description: >-
                    Task execution priority from 0 to 9. A larger value means
                    higher priority. Supported by the Seedance 2.0 series.
                safety_identifier:
                  type: string
                  description: >-
                    Unique end-user identifier passed through to Ark for
                    compliance checks.
                source:
                  type: string
                  enum:
                    - ai_video
                    - ai_draft_generation
                    - plugin
                  description: Consumption source.
              required:
                - model
                - content
              additionalProperties: false
            examples:
              textToVideo:
                summary: Text generation video
                value:
                  model: doubao-seedance-2-0-260128
                  content:
                    - type: text
                      text: >-
                        Create a cinematic product video with close-up shots,
                        soft studio lighting, and smooth camera movement.
                  generate_audio: true
                  ratio: '16:9'
                  duration: 8
                  watermark: false
      responses:
        '200':
          description: >-
            Native Volcengine-format response, not wrapped in the AiToEarn
            common response envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VolcengineVideoGenerationResponseVo'
              examples:
                success:
                  summary: Success
                  value:
                    id: 6a461da66fe8a12d33daabdd
      security:
        - apikey-header-X-Api-Key: []
components:
  schemas:
    VolcengineVideoGenerationResponseVo:
      type: object
      properties:
        id:
          type: string
      required:
        - id
      additionalProperties: false
  securitySchemes:
    apikey-header-X-Api-Key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        Need to get API Key from AiToEarn. Click to go to ["API Key Obtaining
        Tutorial"](/en/use/api-key).

````