DummyImage占位图片生成API

接入教程

1.访问官网https://dummyimage.com查看示例
2.在URL中使用格式：https://dummyimage.com/宽x高/背景色/前景色?text=文字
3.将参数替换为所需值（如600x400/cccccc/000000?text=示例）
4.直接粘贴URL到浏览器即可生成图片
5.在HTML代码中作为图片源引用
6.可选参数包括图片格式和文字大小调整

使用Python请求占位图片

python

import requests

# DummyImage API基础URL
base_url = 'https://dummyimage.com'

# 设置图片参数
params = {
    'size': '600x400',
    'bgcolor': 'cccccc',
    'color': '000000',
    'text': 'Placeholder+Image'
}

# 构建请求URL
url = f"{base_url}/{params['size']}/{params['bgcolor']}/{params['color']}"
url += f"?text={params['text']}"

# 发送请求获取图片
response = requests.get(url)
if response.status_code == 200:
    with open('placeholder.png', 'wb') as f:
        f.write(response.content)
    print("图片已保存为placeholder.png")
else:
    print(f"请求失败，状态码: {response.status_code}")

使用PHP获取占位图片

php

<?php
// DummyImage API基础URL
$base_url = 'https://dummyimage.com';

// 图片参数
$size = '800x600';
$bgcolor = '336699';
$color = 'ffffff';
$text = urlencode('Sample+Image');

// 构建完整URL
$image_url = "$base_url/$size/$bgcolor/$color?text=$text";

// 下载图片
$image_data = file_get_contents($image_url);

if ($image_data !== false) {
    file_put_contents('placeholder.jpg', $image_data);
    echo "图片已保存为placeholder.jpg\n";
} else {
    echo "无法获取图片\n";
}
?>

使用JavaScript获取占位图片

javascript

// DummyImage API基础URL
const baseUrl = 'https://dummyimage.com';

// 图片参数
const imageParams = {
    size: '400x300',
    bgcolor: 'ff9900',
    color: '333333',
    text: 'Demo+Image'
};

// 构建图片URL
const imageUrl = `${baseUrl}/${imageParams.size}/${imageParams.bgcolor}/${imageParams.color}?text=${encodeURIComponent(imageParams.text)}`;

// 在浏览器中使用
// 可以直接设置img标签的src属性
document.getElementById('placeholder-img').src = imageUrl;

// 或者使用fetch API获取图片数据
async function downloadImage() {
    try {
        const response = await fetch(imageUrl);
        if (response.ok) {
            const blob = await response.blob();
            console.log('图片获取成功，大小:', blob.size, 'bytes');
        } else {
            console.error('获取图片失败:', response.status);
        }
    } catch (error) {
        console.error('请求出错:', error);
    }
}

常见问题

DummyImage API需要注册或API密钥吗？

不需要。DummyImage是一个完全免费的API服务，无需注册、无需API密钥、无需身份验证。您可以直接通过构造URL来使用该服务，没有任何使用限制。

支持哪些图片格式和参数？

DummyImage支持PNG、JPEG和GIF格式（默认为PNG）。主要参数包括：尺寸（如300x250）、背景色（16进制颜色码）、文字颜色和自定义文字。所有参数都通过URL路径和查询字符串传递。

这个API有使用限制或速率限制吗？

DummyImage没有明确的速率限制，但由于是免费公共服务，建议合理使用以避免对服务造成压力。对于高频率或商业用途，建议考虑自托管解决方案或寻找替代服务。