HotshotXL Serverless API

A text-to-GIF model that works on Stable Diffusion XL.

~27.05s
PlaygroundAPI
Pricing
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/hotshot-xl"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "mp4": false,
12    "seed": 6226,
13    "steps": 30,
14    "width": 672,
15    "height": 384,
16    "prompt": "a dog running towards you with a smile, hd, high quality",
17    "scheduler": "EulerAncestralDiscreteScheduler",
18    "negative_prompt": "blurry"
19}
20
21response = requests.post(url, headers=headers, json=data)
22
23if response.status_code == 200:
24    result = response.json()
25    print(json.dumps(result, indent=2))
26else:
27    print(f"Error: {response.status_code}")
28    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/hotshot-xl

Parameters

heightoptional
integer

An enumeration.

Default: 384
Allowed values (14 total):
256320384448512576640672704768+4 more
mp4optional
boolean

Save as mp4, False for GIF

Default: false
negative_promptoptional
string

Negative prompt

Default: "blurry"
promptoptional
string

Input prompt

Default: ""
scheduleroptional
string

An enumeration.

Default: "EulerAncestralDiscreteScheduler"
Allowed values :
"DDIMScheduler""DPMSolverMultistepScheduler""HeunDiscreteScheduler""KarrasDPM""EulerAncestralDiscreteScheduler""EulerDiscreteScheduler""PNDMScheduler"
seedoptional
integer

Random seed. Leave blank to randomize the seed

Default: 6226
stepsoptional
integer

Number of denoising steps

Default: 30Range: 1 - 500
widthoptional
integer

An enumeration.

Default: 672
Allowed values (14 total):
256320384448512576640672704768+4 more

Response Type

Returns: Image

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out