> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Veo Videos ## OpenAPI ````yaml /openapi/veo.json post /veo/videos openapi: 3.0.0 info: title: Veo Video Generation version: 1.0.0 description: API reference for Veo Video Generation on Ace Data Cloud. servers: - url: https://api.acedata.cloud description: Ace Data Cloud API security: - bearerAuth: [] paths: /veo/videos: post: summary: Veo Videos operationId: generateVeoVideo parameters: - in: header name: accept schema: enum: - application/json type: string required: false description: Veo Videos Param Accept requestBody: content: application/json: schema: type: object required: - action properties: model: enum: - veo3 - veo3-fast - veo31-fast - veo31 - veo31-fast-ingredients type: string description: Veo Videos Model resolution: enum: - 4k - 1080p - gif type: string description: Veo Videos Resolution action: enum: - text2video - image2video - ingredients2video - get1080p type: string description: Veo Videos Action prompt: type: string example: >- White ceramic coffee mug on glossy marble counter, top with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle. description: Veo Videos Prompt video_id: type: string description: Veo Videos Video Id translation: type: boolean description: Veo Videos Translation aspect_ratio: enum: - '16:9' - '9:16' type: string description: Veo Videos Aspect Ratio image_urls: type: array items: type: string description: Veo Videos Image Urls callback_url: type: string description: Veo Videos Callback Url async: type: boolean description: Veo Videos Async example: action: text2video prompt: >- White ceramic coffee mug on glossy marble counter, top with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle. required: true responses: '200': content: application/json: schema: oneOf: - $ref: '#/components/schemas/VeoAsyncAccepted' - $ref: '#/components/schemas/VeoCompletedResponse' examples: accepted: value: task_id: 550e8400-e29b-41d4-a716-446655440000 completed: value: success: true task_id: 550e8400-e29b-41d4-a716-446655440000 trace_id: 550e8400-e29b-41d4-a716-446655440001 started_at: 1786281000.123 finished_at: 1786281045.456 elapsed: 45.333 data: - id: veo-video-01 video_url: https://cdn.acedata.cloud/veo/veo-video-01.mp4 created_at: '2026-08-09T14:30:00Z' complete_at: '2026-08-09T14:30:45Z' state: succeeded description: Veo Videos Response 200 '400': content: application/json: schema: oneOf: - type: object example: error: code: token_mismatched message: The specified token is not matched with API. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: token_mismatched description: Veo Videos Response 400 Error Code message: type: string example: The specified token is not matched with API. description: Veo Videos Response 400 Error Message trace_id: type: string description: Veo Videos Response 400 Trace Id - type: object example: error: code: api_not_implemented message: The API is not implemented. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: api_not_implemented description: Veo Videos Response 400 Error Code 2 message: type: string example: The API is not implemented. description: Veo Videos Response 400 Error Message 2 trace_id: type: string description: Veo Videos Response 400 Trace Id 2 - type: object example: error: code: disabled message: >- Your application has been disabled by Ace Data Cloud due to abnormal usage behavior, please contact our support to get more information. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: disabled description: Veo Videos Response 400 Error Code 3 message: type: string example: >- Your application has been disabled by Ace Data Cloud due to abnormal usage behavior, please contact our support to get more information. description: Veo Videos Response 400 Error Message 3 trace_id: type: string description: Veo Videos Response 400 Trace Id 3 - type: object example: error: code: bad_request message: model is invalid. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: bad_request description: Veo Videos Response 400 Error Code 4 message: type: string example: model is invalid. description: Veo Videos Response 400 Error Message 4 trace_id: type: string description: Veo Videos Response 400 Trace Id 4 - type: object example: error: code: no_token message: No token specified for the request. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: no_token description: Veo Videos Response 400 Error Code 5 message: type: string example: No token specified for the request. description: Veo Videos Response 400 Error Message 5 trace_id: type: string description: Veo Videos Response 400 Trace Id 5 description: Veo Videos Response 400 '401': content: application/json: schema: oneOf: - type: object example: error: code: invalid_token message: The specified token is invalid or wrong. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: invalid_token description: Veo Videos Response 401 Error Code message: type: string example: The specified token is invalid or wrong. description: Veo Videos Response 401 Error Message trace_id: type: string description: Veo Videos Response 401 Trace Id - type: object example: error: code: token_expired message: token expired. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: token_expired description: Veo Videos Response 401 Error Code 2 message: type: string example: token expired. description: Veo Videos Response 401 Error Message 2 trace_id: type: string description: Veo Videos Response 401 Trace Id 2 - type: object example: error: code: token_mismatched message: token and api does not match. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: token_mismatched description: Veo Videos Response 401 Error Code 3 message: type: string example: token and api does not match. description: Veo Videos Response 401 Error Message 3 trace_id: type: string description: Veo Videos Response 401 Trace Id 3 description: Veo Videos Response 401 '403': content: application/json: schema: oneOf: - type: object example: error: code: used_up message: >- Your balance is not sufficient for current request, please buy more in Ace Data Cloud. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: used_up description: Veo Videos Response 403 Error Code message: type: string example: >- Your balance is not sufficient for current request, please buy more in Ace Data Cloud. description: Veo Videos Response 403 Error Message trace_id: type: string description: Veo Videos Response 403 Trace Id description: Veo Videos Response 403 '404': content: application/json: schema: oneOf: - type: object example: error: code: no_api message: API does not exist, please make sure url is correct. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: no_api description: Veo Videos Response 404 Error Code message: type: string example: >- API does not exist, please make sure url is correct. description: Veo Videos Response 404 Error Message trace_id: type: string description: Veo Videos Response 404 Trace Id description: Veo Videos Response 404 '429': content: application/json: schema: oneOf: - type: object example: error: code: too_many_requests message: You have exceeded the rate limit. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: too_many_requests description: Veo Videos Response 429 Error Code message: type: string example: You have exceeded the rate limit. description: Veo Videos Response 429 Error Message trace_id: type: string description: Veo Videos Response 429 Trace Id description: Veo Videos Response 429 '500': content: application/json: schema: oneOf: - type: object example: error: code: api_error message: Internal server error. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: api_error description: Veo Videos Response 500 Error Code message: type: string example: Internal server error. description: Veo Videos Response 500 Error Message trace_id: type: string description: Veo Videos Response 500 Trace Id description: Veo Videos Response 500 security: - bearerAuth: [] components: schemas: VeoAsyncAccepted: type: object required: - task_id properties: task_id: type: string format: uuid description: Openapi.437A75587C5B434190884A54443A78A4.Task Id.391D5E1B15B6 VeoCompletedResponse: type: object required: - success - task_id - trace_id - data properties: success: type: boolean enum: - true description: Openapi.437A75587C5B434190884A54443A78A4.Success.0818D2Bf11Ac task_id: type: string format: uuid description: Openapi.437A75587C5B434190884A54443A78A4.Task Id.23E4E266A368 trace_id: type: string format: uuid description: Openapi.437A75587C5B434190884A54443A78A4.Trace Id.673Ca8F602C3 started_at: type: number format: double description: Openapi.437A75587C5B434190884A54443A78A4.Started At.18334713443C finished_at: type: number format: double description: Openapi.437A75587C5B434190884A54443A78A4.Finished At.4Bdcff45Dcc5 elapsed: type: number format: double minimum: 0 description: Openapi.437A75587C5B434190884A54443A78A4.Elapsed.082F85B230Fc data: type: array items: $ref: '#/components/schemas/VeoVideo' description: Openapi.437A75587C5B434190884A54443A78A4.Data.0948185Eb2D4 cost: type: object additionalProperties: true description: Openapi.437A75587C5B434190884A54443A78A4.Cost.91Aedf4C6722 VeoVideo: type: object properties: id: type: string description: Openapi.437A75587C5B434190884A54443A78A4.Id.Ade49Eda72Fe video_url: type: string format: uri description: Openapi.437A75587C5B434190884A54443A78A4.Video Url.471967B2C6Aa created_at: type: string description: Openapi.437A75587C5B434190884A54443A78A4.Created At.Bbb0A8A41F9C complete_at: type: string description: Openapi.437A75587C5B434190884A54443A78A4.Complete At.4Aae39029A7B state: type: string description: Openapi.437A75587C5B434190884A54443A78A4.State.2E8F2C0Defdd is_extend_result: type: boolean description: >- Openapi.437A75587C5B434190884A54443A78A4.Is Extend Result.94Ad1302A1F8 aspect_ratio: type: string description: Openapi.437A75587C5B434190884A54443A78A4.Aspect Ratio.45Fe8217D194 securitySchemes: bearerAuth: type: http scheme: bearer description: API token from https://platform.acedata.cloud ````