API 文档

IMG.TG 并不开放公共 API 以防止滥用，如果有需要请通过赞助开通您的专属 API。

API 没有速率限制，但受到 IMG.TG 上传限制的影响，您应该只将 API 用于自己的应用程序而不是公开使用。

API Key

赞助后请通过注册邮箱联系我们，并附上赞助的订单号，查实后会通过邮件发送给您唯一的 API 密钥。

注意：因 API 密钥泄露导致的滥用我们将永久封禁您的账户，请务必妥善保管您的 API 密钥。

请求方法

API 的调用可以使用 POST 或 GET 请求方法，但由于 GET 请求受 URL 最大允许长度限制，建议优先选择 POST 请求方法。

请求格式

https://img.tg/<UserID>/<ApiVersion>/<action>/

请求参数

[UserID]: 您可以在设置页面中看到您的用户 ID
[ApiVersion]: 当前 API 版本为 v1 [values: 1]
[key]: API 密钥
[action]: 您想要执行的操作 [values: upload]
[source]: 图像 URL 或 base64 编码的图像字符串，您还可以在请求中使用 FILES["source"]
[format]: 设置返回格式 [values: json | txt | redirect]

调用示例

假设您的用户 ID 为 1000：

POST https://img.tg/1000/1/upload/?key=apikey123456&source=https://image.url/image.jpg&format=json

注意：在上传文件时，请始终使用 POST 方法，由于编码字符或 GET 请求的 URL 长度限制，URL 编码可能会改变 base64 来源。

API 响应

API 的响应将根据格式参数而有所不同：

[json]: 以 JSON 格式显示所有已上传的图像信息。[默认]
[txt]: 以 text/plain 格式返回图片直链。
[redirect]: 重定向到本站图片页面。

使用 JSON 时，响应将具有头部状态码，以便您可以轻松地注意到请求是否成功，它还会输出 status_txt 和 status_code 属性。

响应示例 (JSON)

{
    "status_code": 200,
    "success": {
        "message": "image uploaded",
        "code": 200
    },
    "image": {
        "name": "example",
        "extension": "png",
        "size": 53237,
        "width": 1151,
        "height": 898,
        "date": "2014-06-04 15:32:33",
        "date_gmt": "2014-06-04 19:32:33",
        "storage_id": null,
        "description": null,
        "nsfw": "0",
        "md5": "c684350d722c956c362ab70299735830",
        "storage": "datefolder",
        "original_filename": "example.png",
        "original_exifdata": null,
        "views": "0",
        "id_encoded": "L",
        "filename": "example.png",
        "ratio": 1.2817371937639,
        "size_formatted": "52 KB",
        "mime": "image/png",
        "bits": 8,
        "channels": null,
        "url": "https://img.tg/images/2023/10/22/example.png",
        "url_viewer": "https://img.tg/image/L",
        "thumb": {
            "filename": "example.th.png",
            "name": "example.th",
            "width": 160,
            "height": 160,
            "ratio": 1,
            "size": 17848,
            "size_formatted": "17.4 KB",
            "mime": "image/png",
            "extension": "png",
            "bits": 8,
            "channels": null,
            "url": "https://img.tg/images/2023/10/22/example.th.png"
        },
        "medium": {
            "filename": "example.md.png",
            "name": "example.md",
            "width": 500,
            "height": 390,
            "ratio": 1.2820512820513,
            "size": 104448,
            "size_formatted": "102 KB",
            "mime": "image/png",
            "extension": "png",
            "bits": 8,
            "channels": null,
            "url": "https://img.tg/images/2023/10/22/example.md.png"
        },
        "views_label": "views",
        "display_url": "https://img.tg/images/2023/10/22/example.md.png",
        "how_long_ago": "moments ago"
    },
    "status_txt": "OK"
}

响应示例 (txt)

https://img.tg/images/2023/10/22/example.png

响应示例 (redirect)

https://img.tg/image/example

其他使用方法参考

PicGo：IMG.TG 使用 API 对接 PicGo 实现截图自动上传

Discuz：IMG.TG Discuz 论坛图片上传插件