API For AI Video Generator

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 Text To Video

Credits Consumption

model_name	duration	credits
text-1.0-standard	5s	27
	10s	53
text-1.0-turbo	4s	45
	8s	90
text-1.0-pro	5s	45

Request Url

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

Body Attributes

Parameter	Type	Required	Description
model_name	string	true	Options: text-1.0-pro, text-1.0-turbo, text-1.0-standard
prompt	string	true	Describe the video you want to generate. Maximum length: 1500 characters
duration	string	true	Optional values depend on the model: - text-1.0-pro: 5s - text-1.0-turbo: 4s, 8s - text-1.0-standard: 5s, 10s
video_ratio	string	false	Options: 16:9 (default), 9:16, 1:1

demo

import requests

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

payload = {
    'model_name': 'text-1.0-standard',
    'prompt': 'A butterfly is flying over a grassy field.',
    'duration': '5',
    'video_ratio': '1:1'
}

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

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

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

Create Job For Image To Video

Credits Consumption

model_name	duration	credits
image-1.0-standard	5s	27
	10s	53
image-1.0-pro	5s	45
	10s	90
image-1.0-turbo	4s	27
	8s	45
image-1.0-animation	5s	45

Request Url

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

Body Attributes

Parameter	Type	Required	Description
model_name	string	true	Options: image-1.0-standard, image-1.0-pro, image-1.0-turbo,image-1.0-animation
prompt	string	true	Describe the video you want to generate. Maximum length: 1500 characters
images	List	true	Optional values depend on the model: - image-1.0-standard / image-1.0-pro / image-1.0-animation: Only accepts 1 image - image-1.0-turbo: Accepts 1 or 2 images (2 images for first and last frames) Max file size: 10 MB
duration	string	true	Optional values depend on the model: - image-1.0-standard: 5s, 10s - image-1.0-pro: 5s, 10s - image-1.0-turbo: 4s, 8s - image-1.0-animation: 5s

demo

import requests

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

payload = {
    'model_name': 'image-1.0-standard',
    'prompt': 'Two characters engage in a fast-paced fight, exchanging punches and dodges. Motion Level: medium. Keep the background simple and supportive.',
    'duration': '5',
    'images': ['https://image.remaker.ai/datarm30/ai_video_generator/input/2025-04-25/f2f5d100-2d53-4fba-bde4-32785bdcad5d.jpg',]
}

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

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

{
    "code": 100000,
    "result": {
        "job_id": "tnhnmn96exrmc0cpda4rmfmx7r"
    },
    "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/tnhnmn96exrmc0cpda4rmfmx7r'

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-04-25/f1e6b02b-1c2d-4fa3-9ed5-7ed23943d634.mp4",
            "thumbnail_path": "https://image.remaker.ai/datarm30/ai_video_generator/thumbnail/2025-04-25/870d39a3-638b-4dd3-af9e-754683f16ad1.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