> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Hailuo 2.3 Image to Video > Turn a starting image into a 768p video with Hailuo 2.3 Standard, using text and optional prompt refinement to guide the motion. 1. Submit the request with `VIDGO_API_KEY`. A `task_id` is returned immediately. Keep it until the task reaches `finished` or `failed`. 2. Use [Query Task Status](/api-manual/task-management/status) to retrieve the result. If you provide a `callback_url`, Vidgo sends the result to your [webhook](/api-manual/task-management/webhooks) when the task finishes or fails. # Hailuo 2.3 Image to Video Turn a starting image into a 768p video with Hailuo 2.3 Standard, using text and optional prompt refinement to guide the motion. ## Available Models * **minimax/hailuo-2.3/standard/image-to-video** - Generate video from image input. ## Duration Options * **6, 10 seconds** - Set `duration` as an integer. Optional. Default: **6 seconds**. ## Key Features * Generate video from image input. * Use `start_image_url` to supply the starting frame. * This model ID fixes the output resolution to `768p`. ## Advanced Parameters Set `model` and optional `callback_url` at the request root. Place all workflow parameters, including output options, inside `input`. Send only the input fields supported by this workflow. JSON types are validated without converting strings to numbers or booleans; `prompt` must be a string and fractional durations are rejected. Unsupported `input` fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials. ### Prompt * `prompt`: Required. Describe the scene and desired motion. Length: **1-5,000 characters**. * The value must not be blank when supplied. ### Resolution * `resolution`: Optional. Accepted values: `768p`. Default: `768p`. ### Start Image URL * `start_image_url`: Required. Provide the starting frame URL. Use a publicly accessible HTTP(S) URL. ### Prompt Optimizer * `prompt_optimizer`: Optional. Control automatic prompt optimization. Use `true` or `false`. Omit this field to leave it unspecified upstream; no API default is imposed. ## Billing Factors Billing depends on video duration (`duration`) using the Standard model tier. This endpoint fixes output resolution to `768p`. Prompt optimization (`prompt_optimizer`) does not change the charge. Credits are deducted on submission and refunded if the task fails. ## OpenAPI ````yaml api-manual/video-series/minimax-hailuo-2-3-standard-image-to-video.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Hailuo 2.3 Image to Video description: >- Turn a starting image into a 768p video with Hailuo 2.3 Standard, using text and optional prompt refinement to guide the motion. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Video Series summary: Hailuo 2.3 Image to Video description: >- Send only the fields shown for this workflow. Parameters from other workflows are rejected before credits are deducted. prompt is required and must not be blank. Input URL fields require HTTP(S) URLs with a hostname and no embedded credentials. This ID fixes `resolution` to `768p`. No type coercion: numeric prompts, string booleans and fractional durations are rejected. Billing depends on video duration (`duration`) using the Standard model tier. This endpoint fixes output resolution to `768p`. Prompt optimization (`prompt_optimizer`) does not change the charge. operationId: submit_minimax_hailuo_2_3_standard_image_to_video requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string example: minimax/hailuo-2.3/standard/image-to-video input: type: object required: - prompt - start_image_url properties: prompt: type: string maxLength: 5000 minLength: 1 description: >- Required nonblank string, trimmed before validation. Maximum 5,000 Unicode characters. duration: type: integer enum: - 6 - 10 default: 6 description: Output duration in seconds. 6 or 10; defaults to 6. resolution: type: string enum: - 768p default: 768p description: Fixed to 768p for this endpoint. start_image_url: type: string format: uri description: >- Required first-frame HTTP(S) image URL with a hostname and no embedded credentials. Data URLs and arrays are not supported. prompt_optimizer: type: boolean description: >- Optional boolean. Omit to leave unspecified upstream. No extra charge. additionalProperties: false callback_url: type: string nullable: true description: >- Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks. description: >- Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected. examples: basic: summary: Basic workflow value: model: minimax/hailuo-2.3/standard/image-to-video input: prompt: >- A quiet forest under soft morning light, with natural detail. start_image_url: https://example.com/image.png duration: 6 resolution: 768p callback: summary: Receive a completion callback value: model: minimax/hailuo-2.3/standard/image-to-video input: prompt: >- A quiet forest under soft morning light, with natural detail. start_image_url: https://example.com/image.png duration: 6 resolution: 768p callback_url: https://your-domain.com/callback responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: task-unified-example status: running created_time: '2026-09-10T08:00:00' '400': description: >- Invalid input, unsupported tier, inaccessible media, or insufficient credits content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: Invalid credentials content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: Rate or API key credit limit exceeded content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: Internal error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: Unable to create the upstream generation task content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: Model configuration or capability is not approved content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: Use VIDGO_API_KEY. ````