Image

Image to Base64

0calls

2 credits / call

See a picture on the web and want to convert it to Base64 encoding so you can embed it in your HTML or CSS? This endpoint is for you.

GET

uapis.cn

/api/v1/image/tobase64

Query parameters

url

string

required

The publicly accessible image URL address that needs to be converted to Base64.

Overview

You provide a publicly accessible image URL, we help you download it and convert it to a Base64 Data URI string containing MIME type and return it to you.

Query parameters

url

stringrequired

The publicly accessible image URL address that needs to be converted to Base64.

Name	Type	Attributes	Description
`url`	string	required	The publicly accessible image URL address that needs to be converted to Base64.

Response

200 / OK

Conversion successful! Returns a JSON object containing the Base64 encoded string.

JSON

{
  // The complete Base64 Data URI after conversion, ready to use in CSS or HTML.
  "base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
  // Operation result description.
  "msg": "success"
}

400 / Bad Request

Request parameter error. Please check if you provided the url parameter and if it is a valid URL format.

JSON

{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing or invalid 'url' parameter."
}

502 / Bad Gateway

Failed to retrieve image. We were unable to download the image from the provided URL. Please check if the URL is publicly accessible and points to a valid image resource.

JSON

{
  "code": "UPSTREAM_ERROR",
  "details": {},
  "message": "Failed to fetch image from the provided URL."
}

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/image/tobase64?url=https://ts3.tc.mm.bing.net/th?id=ORMS.44196851bb1757ec3f66572811fe8e07&pid=Wdp&w=612&h=304&qlt=90&c=1&rs=1&dpr=1.25&p=0'

Frequently asked questions

Are there any special restrictions for the Image to Base64 API?

Image to Base64 follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

Related APIs

Upload Image via Base64 Encoding

When you need to process images on the frontend (such as after cropping or applying filters) and upload them directly without traditional forms, this endpoint comes in handy.

Generate QR Code

Whether it's a URL, text or contact information, it can all be turned into a QR code! This is a very flexible QR code generation tool.

Lossless Image Compression

Still worried about image size and loading speed? Experience our powerful lossless compression service, which can compress image size to the extreme while hardly sacrificing any visually perceptible image quality.

Base64 Encode

This is a simple and practical Base64 encoding tool.

PreviousGenerate QR Code

NextDecode and Scale Image