Versioning

The API supports versioning through the Accept-Version header. Pinning your requests to a specific version protects your integration from breaking changes.

Current Version

The latest API version is v7.

Specifying a Version

Include the Accept-Version header in your requests:

cURL

curl -H "Accept-Version: v7" https://api.waifu.im/images

JavaScript

const response = await fetch("https://api.waifu.im/images", {
  headers: { "Accept-Version": "v7" },
});

Python

import requests

response = requests.get(
    "https://api.waifu.im/images",
    headers={"Accept-Version": "v7"}
)

C#

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept-Version", "v7");
var response = await client.GetAsync("https://api.waifu.im/images");

Default Behavior

If you do not specify a version, the API uses the latest available version. This can break your application if a new version introduces breaking changes.

Best practice: always include the Accept-Version header in production code.