> ## 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 02 Image to Video > Animate still images with Hailuo 02 Standard, with text guidance, prompt refinement, and an optional closing frame to shape the shot. 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 02 Image to Video Animate still images with Hailuo 02 Standard, with text guidance, prompt refinement, and an optional closing frame to shape the shot. ## Available Models * **minimax/hailuo-02/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. * Accepts exactly 1 image in `image_urls`. * Optionally supply an ending frame with `end_image_url`. * Accepts `512P` or `768P` resolution; defaults 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. 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-1,500 characters**. * Whitespace is trimmed before validation; the result must not be blank. ### Image URLs * `image_urls`: Required. Provide publicly accessible image URLs. Supply exactly 1 item. Each item must be an HTTP(S) URL. ### End Image URL * `end_image_url`: Optional. Provide the ending frame URL. Use a publicly accessible HTTP(S) URL. Requires a starting image in `image_urls`. Standard requires `768P` when an ending frame is supplied. ### Resolution * `resolution`: Optional. Accepted values: `512P`, `768P`. Default: `768P`. ### Prompt Optimizer * `prompt_optimizer`: Optional. Control automatic prompt optimization. Use `true` or `false`. ## Pricing 512P: 3 credits/second, 18 credits ($0.09) for 6 seconds or 30 credits ($0.15) for 10 seconds. 768P: 7 credits/second, 42 credits ($0.21) for 6 seconds or 70 credits ($0.35) for 10 seconds. 1 credit = \$0.005. Credits are deducted on submission and refunded if the task fails. ## OpenAPI ````yaml api-manual/video-series/minimax-hailuo-02-standard-image-to-video.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Hailuo 02 Image to Video description: >- Animate still images with Hailuo 02 Standard, with text guidance, prompt refinement, and an optional closing frame to shape the shot. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Video Series summary: Hailuo 02 Image to Video description: >- Send only the fields shown for this workflow. Parameters from other workflows are rejected before credits are deducted. When supplied, prompt and text must not be blank. Input URL fields require HTTP(S) URLs with a hostname and no embedded credentials. Standard accepts 512P and 768P (default 768P), and 6 or 10 seconds (default 6). Standard end_image_url requires 768P. operationId: submit_minimax_hailuo_02_standard_image_to_video requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string enum: - minimax/hailuo-02/standard/image-to-video example: minimax/hailuo-02/standard/image-to-video description: >- Vidgo public model ID. Must be `minimax/hailuo-02/standard/image-to-video`. input: type: object required: - image_urls - prompt description: Input parameters for generation properties: prompt: type: string description: >- Required nonblank prompt, trimmed before validation. Maximum 1500 Unicode characters. maxLength: 1500 example: A cinematic video scene minLength: 1 image_urls: type: array items: type: string format: uri maxItems: 1 description: >- Reference image URLs for image-to-video generation (required for image-to-video) example: - https://example.com/start.png minItems: 1 end_image_url: type: string format: uri description: >- Optional last-frame image URL; requires image_urls. Standard requires 768P when using an end frame. example: https://example.com/end_image.png duration: type: integer description: Video duration in seconds. Defaults to 6. enum: - 6 - 10 example: 6 default: 6 resolution: type: string description: Resolution passed to PoYo. Defaults to 768P. enum: - 512P - 768P default: 768P example: 768P prompt_optimizer: type: boolean description: Enable AI-powered prompt optimization example: true 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-02/standard/image-to-video input: image_urls: - https://example.com/image.png prompt: >- A quiet forest under soft morning light, with natural detail. duration: 6 resolution: 768P callback: summary: Receive a completion callback value: model: minimax/hailuo-02/standard/image-to-video input: image_urls: - https://example.com/image.png prompt: >- A quiet forest under soft morning light, with natural detail. 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. ````