Skip to content

Task: Image-to-Video

Description: Jimeng AI image-to-video generation API. Output videos default to 5 seconds. Image-to-video quality is generally better than text-to-video. Rewritten in models-model.md style while preserving original parameters and example semantics.

Overview

  • Path: POST /task/jimeng/image2video
  • Category: Video Models (Video) / Jimeng AI
  • Authentication: Bearer Token
  • Base URL: https://api.gpt.ge

Request Parameters

Request body (application/json):

  • prompt (string): prompt text for generating the video, supports Chinese and English, within 150 characters. It is recommended to match the input image content.
  • seed (integer, optional, default -1): random seed. When the same positive integer seed and other parameters are identical, results are more stable.
  • aspect_ratio (string, optional): video aspect ratio, supports: 16:9 (1280720, default), 9:16 (7201280), 9:21 (7201680), 1:1 (960960), 4:3 (960720), 3:4 (720960), 21:9 (1680720).
  • binary_data_base64 (array[string], optional): array of image Base64 data. Mutually exclusive with image_urls; binary_data_base64 takes precedence if both are provided.
  • image_urls (array[string], optional): array of image URLs. Mutually exclusive with binary_data_base64.

Business Error Codes

  • 10000: request succeeded
  • 50500: Internal Error (generated video failed moderation)
  • 50412: Text Risk Not Pass (input text failed pre-moderation)
  • 50413: Post Text Risk Not Pass (input text blocked for copyright or other risks)

Request Example

bash
curl -X POST "https://api.gpt.ge/task/jimeng/image2video" \
  -H "Authorization: Bearer $YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "image_urls": ["https://p9-dreamina-sign.byteimg.com/tos-cn-i-tb4s082cfz/77b465e975094c5f9e329d1335a9a9f7~tplv-tb4s082cfz-resize:0:0.image?lk3s=8e790bc3&x-expires=1777645873&x-signature=JuqKwKPGF6h2ZSIYH1JZAISkkhg%3D"],
    "prompt": "A golden retriever travels along a winding mountain road...",
    "aspect_ratio": "9:16"
  }'

Success Response Example

json
{
  "code": 10000,
  "data": {"task_id": "14117763723766220057"},
  "message": "Success",
  "request_id": "20250501223433B728875839C8FE1F4DBF",
  "status": 10000,
  "time_elapsed": "55.764678ms"
}

Notes

  • The generated video URL expires quickly (typically 1 hour), so download it promptly.
  • This endpoint returns only the task ID. You must call the task query API to obtain the final result.
  • Pass the token in the header as Authorization: Bearer $YOUR_TOKEN.