API For AI Video Template

Considerations

1. Before using the API, make sure you have obtained the API key. Refer to the link below for instructions on how to obtain it. API For API Key Settings
2. All generated Video will be automatically deleted after 30 days. Please make sure to save the Video you need to your local storage in a timely manner.

Header Attributes

Parameter	Description
Authorization	Your API Key used for request authorization.

Create Job For AI Video Template

Credits Consumption

template_name	duration	credits
ai-kissing	4s	27
ai-hug	4s	27
ai-fight	4s	27
ai-handshake	4s	27
the-tiger-touch	4s	27
ai-batman-transformation	4s	27
ai-smile-generator	4s	27
ai-pinch-effect	4s	27
instant-flight	4s	30
romantic-princess-carry	4s	30
ai-twerk-video-generator	4s	27
ai-bikini	4s	27
ai-jiggle-video-effect	4s	27
ai-squat-twerk-video-generator	4s	27
ai-tongue-out-face	4s	27
rain-kiss	4s	30
sweet-proposal	4s	30
cupid-arrow	4s	30

Request Url

--request POST https://developer.remaker.ai/api/remaker/v1/ai-video-generator/create-job-template

Body Attributes

Parameter	Type	Required	Description
template_name	string	true	Options: ai-kissing, ai-hug, ai-fight, ai-handshake, the-tiger-touch, ai-batman-transformation, ai-smile-generator, ai-pinch-effect, instant-flight, romantic-princess-carry,ai-twerk-video-generator,ai-bikini,ai-jiggle-video-effect,ai-squat-twerk-video-generator,ai-tongue-out-face,rain-kiss,sweet-proposal,cupid-arrow
image	file[binary]	true	One image only. Size: ≥300×300px, ≤10MB.
prompt	string	false	Default used if not provided. Max: 1500 characters.

demo

import requests

url = 'https://developer.remaker.ai/api/remaker/v1/ai-video-generator/create-job-template'
headers = {
    'accept': 'application/json',
    'Authorization': 'your token',
}

payload = {
    'template_name': 'ai-hug',
    'image': open('ai-hug.jpg', 'rb'),
}

response = requests.post(url, headers=headers, data=payload)

print(response.json())  # Print the response content

{
    "code": 100000,
    "result": {
        "job_id": "830268426642530304"
    },
    "message": {
        "en": "Request Success",
        "zh": "请求成功"
    }
}

Fetch Job

Request Url

--request GET https://developer.remaker.ai/api/remaker/v1/ai-video-generator/get-job/{job_id}

Body Attributes

Parameter	Description
job_id	job_id returned by create task

demo

import requests

url = 'https://developer.remaker.ai/api/remaker/v1/ai-video-generator/get-job/830268426642530304'

headers = {
    'accept': 'application/json',
    'Authorization': 'your token',
}

response = requests.get(url, headers=headers)

print(response.json())  # Print the response content

{
    "code": 100000,
    "result": {
        "output": {
            "output": "https://image.remaker.ai/datarm30/ai_video_generator/output/2025-06-11/1c3e29dc-cdd6-4a1d-b3e0-69607c231943.mp4",
            "thumbnail_path": "https://image.remaker.ai/datarm30/ai_video_generator/thumbnail/2025-06-11/915f6041-ca68-4ace-80ac-d2a9188f289f.png"
        }
    },
    "message": {
        "en": "Request Success",
        "zh": "请求成功"
    }
}

Status Code

Code	Message
100000	Request Success
200007	Token is Null
300002	Insufficient credits
300004	Resource does not exist
300013	Task in progress
400000	Request Failure
400301	Params error
600001	The video generation status is failed