promptstringrequired
The text prompt to generate an image from.
Default: "A rustic farm-to-table feast on a weathered wooden table, overhead food photograph, warm side light"
MiniMax H3 Image Text to Image
minimax/h3-imageMiniMax H3 Image is MiniMax's flagship image generation model from the H3 family, turning text prompts into detailed, photorealistic images with built-in prompt enhancement, aspect ratios from 1:3 to 3:1 and 1K, 2K or 4K output.
Try the model
Playground
Input
The text prompt to generate an image from.
Output aspect ratio. Allowed values: 21:9, 16:9, 2:1, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 1:2, 9:16, 9:21, 3:1, 1:3.
Output resolution tier: 1K (about 1 MP), 2K (about 4 MP) or 4K (about 16 MP). Allowed values: 1K, 2K, 4K.
Advanced settings
The format of the generated image. Allowed values: jpeg, png, webp.
ResultExample
What would you like to do next?
Examples
Select an example to load its inputs and result into the playground.
- Open result ↗
Input
{ "aspect_ratio": "16:9", "prompt": "A rustic farm-to-table feast on a weathered wooden table, overhead food photograph, warm side light", "resolution": "1K" } - Open result ↗
Input
{ "aspect_ratio": "16:9", "prompt": "Widescreen cinematic photo of a tiny ramen shop on a rainy Tokyo side street at night, glowing red lantern and a neon sign that reads \"MIDNIGHT NOODLES\", steam rising from the open kitchen, reflections on wet cobblestones, a cyclist with a clear umbrella passing by, shallow depth of field", "resolution": "1K" }
Start building
Send your first request
Submit this model through the SandBase Unified Run API.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "minimax/h3-image",
"prompt": "A rustic farm-to-table feast on a weathered wooden table, overhead food photograph, warm side light",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "png"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"2. Authentication
Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"4. Files
Hosted files
Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Uploading images
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
5. Schema
Input
resolutionstring
Output resolution tier: 1K (about 1 MP), 2K (about 4 MP) or 4K (about 16 MP).
Default: "1K"
Possible values: "1K", "2K", "4K"
aspect_ratiostring
Output aspect ratio.
Default: "1:1"
Possible values: "21:9", "16:9", "2:1", "3:2", "4:3", "5:4", "1:1", "4:5", "3:4", "2:3", "1:2", "9:16", "9:21", "3:1", "1:3"
output_formatstring
The format of the generated image.
Default: "png"
Possible values: "jpeg", "png", "webp"
{
"model": "minimax/h3-image",
"prompt": "A rustic farm-to-table feast on a weathered wooden table, overhead food photograph, warm side light",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "png"
}Output
A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
[
{
"url": "https://static.sandbase.ai/examples/962a1dc9-8034-499e-a91d-ff1c9d83e191/output/54bb2742-2049-4e44-ab16-f89596219766.png"
}
]