MiniMax H3 صورة إلى فيديو

01

نظرة عامة

استخدم نقطة نهاية الصورة إلى فيديو مع نموذج مدعوم. استخدم معرّف المهمة المُعاد لاسترداد حالتها، أو أدخل callback_url للتسليمات الموثقة أدناه.

البدء السريع

أنشئ مفتاح API واضبطه كـ RUNAPI_API_KEY.
اختر نموذجاً مدعوماً وأرسل طلب POST يطابق مخطط ذلك النموذج.
احفظ معرّف المهمة المُعاد، ثم استطلع الحالة حتى تبلغ حالة نهائية أو تعالج عمليات الاستدعاء الموثقة أدناه.

POST /api/v1/minimax_h3/image_to_video

عنوان URL الأساسي: https://runapi.ai
إصدار API: v1
المصادقة: Authorization: Bearer YOUR_API_TOKEN

02

النماذج المدعومة

افتح صفحة النموذج للاطلاع على التسعير الحالي وحدود المعدل وتفاصيل الاستخدام التجاري.

MiniMax H3

03

مخطط الطلب

نص JSON

تعتمد الحقول والقيم المسموح بها على النموذج المحدد. عند التوفير، يستقبل callback_url عمليات تسليم المهمة الموثّقة أدناه.

minimax-h37 حقل

callback_urlstring

اختياري

رابط Webhook لإشعارات غير متزامنة.

duration_secondsinteger

اختياري

مدة الفيديو المولَّد بالثواني.

القيم المسموح بها: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 القيمة الافتراضية: 6

first_frame_image_urlstring

اختياري

عنوان URL عام عبر HTTP(S) لصورة الإطار الأول؛ بصيغة JPG أو JPEG أو PNG أو WEBP أو HEIC أو HEIF، بحجم أقصى 30 ميغابايت، وأبعاد تتراوح بين 256 و5760 بكسل لكل ضلع، بنسبة عرض إلى ارتفاع تتراوح بين 0.4 و2.5.

last_frame_image_urlstring

اختياري

عنوان URL عام عبر HTTP(S) لصورة الإطار الأخير؛ بصيغة JPG أو JPEG أو PNG أو WEBP أو HEIC أو HEIF، بحجم أقصى 30 ميغابايت، وأبعاد تتراوح بين 256 و5760 بكسل لكل ضلع، بنسبة عرض إلى ارتفاع تتراوح بين 0.4 و2.5.

modelstring

مطلوب

معرّف النموذج.

output_resolutionstring

اختياري

دقة الفيديو المولَّد.

القيم المسموح بها: 768p, 2k القيمة الافتراضية: 2k

promptstring

مطلوب

موجّه توليد الفيديو.

نطاق: 1 - 7000

القواعد الشرطية

تسري هذه المتطلبات عندما تتطابق جميع الشروط المدرجة.

عندما

مطلوب

غير مقبول

04

إنشاء قبول

HTTP 202

POST /api/v1/minimax_h3/image_to_video

مخطط الاستجابة

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    },
    "task_replayed": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

05

الاستطلاع قيد المعالجة

HTTP 200

GET /api/v1/minimax_h3/image_to_video/:id

مخطط الاستجابة

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

06

اكتمل الاستطلاع

HTTP 200

GET /api/v1/minimax_h3/image_to_video/:id

مخطط الاستجابة

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    },
    "videos": {
      "items": {
        "properties": {
          "url": {
            "type": "string",
            "x-runapi-generated-media": true
          }
        },
        "required": [
          "url"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "status",
    "videos",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

07

فشل الاستطلاع

HTTP 200

GET /api/v1/minimax_h3/image_to_video/:id

مخطط الاستجابة

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "error": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": "Task processing failed.",
  "id": "tsk_reference_demo",
  "status": "failed"
}

08

استدعاء العميل: مكتمل

HTTP 200

POST callback_url

مخطط الاستجابة

JSON

{
  "properties": {
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    },
    "videos": {
      "items": {
        "properties": {
          "url": {
            "type": "string",
            "x-runapi-generated-media": true
          }
        },
        "required": [
          "url"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "status",
    "videos"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

09

استدعاء العميل: فشل

HTTP 200

POST callback_url

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "properties": {
            "code": {
              "type": "string"
            },
            "limit_cents": {
              "type": "integer"
            },
            "message": {
              "type": "string"
            },
            "reset_at": {
              "format": "date-time",
              "type": [
                "string",
                "null"
              ]
            },
            "used_cents": {
              "type": "integer"
            },
            "window": {
              "enum": [
                "1h",
                "1d",
                "7d",
                "daily",
                "weekly",
                "monthly",
                "lifetime"
              ],
              "type": "string"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "type": "object",
          "unevaluatedProperties": false
        }
      ]
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": {
    "code": "generation_failed",
    "message": "Task processing failed."
  },
  "id": "tsk_reference_demo",
  "status": "failed"
}

10

الأخطاء

HTTP 401

POST /api/v1/minimax_h3/image_to_video

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": "Authentication required"
}

11

الأخطاء

HTTP 401

GET /api/v1/minimax_h3/image_to_video/:id

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": "Authentication required"
}

12

الأخطاء

HTTP 400

POST /api/v1/minimax_h3/image_to_video

مخطط الاستجابة

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "رسالة خطأ قابلة للقراءة البشرية.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "ملخص التحقق القابل للقراءة البشرية.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "رسائل التحقق مفتاحها حقل الطلب العام، مع مصفوفة من السلاسل القابلة للقراءة البشرية لكل حقل.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

مثال على الاستجابة

JSON

{
  "error": "model must be one of: minimax-h3"
}

13

الأخطاء

HTTP 402

POST /api/v1/minimax_h3/image_to_video

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": "Insufficient balance"
}

14

الأخطاء

HTTP 429

POST /api/v1/minimax_h3/image_to_video

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": "API key credit limit exceeded"
}

15

الأخطاء

HTTP 409

POST /api/v1/minimax_h3/image_to_video

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": "The request uses features that are not supported for the selected model"
}

16

الأخطاء

HTTP 429

POST /api/v1/minimax_h3/image_to_video

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": "Rate limit reached. Please retry later."
}

17

الأخطاء

HTTP 503

POST /api/v1/minimax_h3/image_to_video

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": "Service under maintenance, please try again later"
}

18

الأخطاء

HTTP 504

POST /api/v1/minimax_h3/image_to_video

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": "The request timed out"
}

19

الأخطاء

HTTP 404

GET /api/v1/minimax_h3/image_to_video/:id

مخطط الاستجابة

JSON

{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

مثال على الاستجابة

JSON

{
  "error": "Task with id 'tsk_reference_demo' not found"
}

20

نماذج الأكواد المولَّدة

استخدم cURL مباشرةً، أو ثبّت SDK للغة البرمجة التي تستخدمها. كل نموذج يُرسل الطلب الذي تم التحقق من صحته كما هو موضح في هذا المرجع.

التثبيت

Shell

pip install runapi-minimax-h3

PYTHON

import os
from runapi.minimax_h3 import MiniMaxH3Client

client = MiniMaxH3Client(api_key=os.environ["RUNAPI_API_KEY"])
task = client.image_to_video.create(
  model="minimax-h3",
  first_frame_image_url="https://cdn.runapi.ai/public/samples/image.jpg",
  prompt="The subject turns toward the camera."
)

التثبيت

Shell

npm install @runapi.ai/minimax-h3

JAVASCRIPT

import { MiniMaxH3Client } from "@runapi.ai/minimax-h3";

const client = new MiniMaxH3Client({ apiKey: process.env.RUNAPI_API_KEY });
const task = await client.imageToVideo.create({
  "model": "minimax-h3",
  "first_frame_image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
  "prompt": "The subject turns toward the camera."
});

CURL

curl -X POST https://runapi.ai/api/v1/minimax_h3/image_to_video \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3","first_frame_image_url":"https://cdn.runapi.ai/public/samples/image.jpg","prompt":"The subject turns toward the camera."}'

التثبيت

Shell

go get github.com/runapi-ai/minimax-h3-sdk/go@latest

GO

package main

import (
  "context"
  "log"
  "os"

  "github.com/runapi-ai/core-sdk/go/option"
  minimaxh3 "github.com/runapi-ai/minimax-h3-sdk/go/minimaxh3"
)

func main() {
  client, err := minimaxh3.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY")))
  if err != nil {
    log.Fatal(err)
  }

  task, err := client.ImageToVideo.Create(context.Background(), minimaxh3.ImageToVideoParams{
    Model: minimaxh3.Model("minimax-h3"),
    FirstFrameImageURL: "https://cdn.runapi.ai/public/samples/image.jpg",
    Prompt: "The subject turns toward the camera.",
  })
  if err != nil {
    log.Fatal(err)
  }
  _ = task
}

21

MiniMax H3 صورة إلى فيديو

نظرة عامة

البدء السريع

نقطة النهاية

النماذج المدعومة

مخطط الطلب

القواعد الشرطية

إنشاء قبول

مثال على الاستجابة

الاستطلاع قيد المعالجة

مثال على الاستجابة

اكتمل الاستطلاع

مثال على الاستجابة

فشل الاستطلاع

مثال على الاستجابة

استدعاء العميل: مكتمل

مثال على الاستجابة

استدعاء العميل: فشل

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

الأخطاء

مثال على الاستجابة

نماذج الأكواد المولَّدة

التثبيت

الأدلة ذات الصلة