Text-to-Video

Overview

• API: POST /task/minimax/v1/video_generation
• Category: Video Models (Video) / Hailuo Video
• Authentication: Bearer Token
• Base URL: https://api.gpt.ge

Request Parameters

Request body (application/json):

• model (string, required): model name, options include MiniMax-Hailuo-2.3, MiniMax-Hailuo-02, T2V-01-Director, T2V-01.
• prompt (string, required): text description for the video, up to 2000 characters. For MiniMax-Hailuo-2.3, MiniMax-Hailuo-02, and *-Director series, prompt may include bracketed directives like [推进], [上升], [固定] to control camera movement. Directives can be combined or sequenced.
• prompt_optimizer (boolean, optional, default true): whether to auto-optimize the prompt. Set to false for more precise control.
• fast_pretreatment (boolean, optional, default false): whether to shorten prompt optimizer runtime (effective for some models only).
• duration (integer, required): video duration in seconds, supports 6 or 10, default is 6; available values depend on model and resolution.
• resolution (string, required): video resolution, available values depend on model (e.g. 720P, 768P, 1080P).
• callback_url (string, optional): callback URL for task status updates. When configured, the server sends a verification request containing challenge; the callback endpoint must return the same value within 3 seconds. After verification passes, status updates are pushed to the URL with the same payload as the query API response. Callback status values may include processing, success, or failed.

Request Example

curl -X POST "https://api.gpt.ge/task/minimax/v1/video_generation" \
  -H "Authorization: Bearer $YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-Hailuo-02",
    "prompt":"A woman picks up a book [上升], then reads it [固定].",
    "duration":6,
    "resolution":"1080P"
  }'

Success Response Example

{
  "task_id": "106916112212032",
  "base_resp": {"status_code": 0, "status_msg": "success"}
}

Response Fields

• task_id (string): task ID for querying results.
• base_resp.status_code (integer): internal status code, 0 means success.
• base_resp.status_msg (string): short status description.

Notes

• Required fields include model, prompt, duration, and resolution.
• If you use callback notifications, ensure callback_url can respond to verification requests by returning the received challenge value.