api.cn402.com · pinyin

Chinese pinyin, hanzi to pinyin, Mandarin romanization, 拼音转换, Chinese phonetic, Hanyu Pinyin with tones, 普通话拼音, Chinese to Latin, Mandarin transliteration, tone marks numbers. Convert Chinese characters to Pinyin (Hanyu Pinyin) with tone marks. For AI agents handling Chinese text-to-speech, Chinese language learning apps.

Call it in 30 seconds

// npm i x402-fetch viem
import { wrapFetchWithPayment } from "x402-fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount(process.env.PRIVATE_KEY); // funds USDC on Base
const wallet = createWalletClient({ account, chain: base, transport: http() });
const fetchWithPay = wrapFetchWithPayment(fetch, wallet);

// Pays the $0.008 USDC automatically on the 402, then returns the real response:
const res = await fetchWithPay("https://api.cn402.com/hanzi/pinyin", { method: "GET" });
console.log(await res.json());

# pip install x402 eth-account httpx
import os, asyncio
from eth_account import Account
from x402.clients.httpx import x402HttpxClient

account = Account.from_key(os.environ["PRIVATE_KEY"])  # funds USDC on Base

async def main():
    async with x402HttpxClient(account=account) as client:
        # x402 handles the 402 -> pay ($0.008 USDC) -> retry automatically
        r = await client.get("https://api.cn402.com/hanzi/pinyin")
        print((await r.aread()).decode())

asyncio.run(main())

# 1) An unpaid request returns HTTP 402 with the exact payment terms:
curl -i "https://api.cn402.com/hanzi/pinyin?style=Style (optional)"

# 2) Paying + retrying requires an x402 client that can sign the USDC
#    authorization (curl alone cannot). See the JS / Python tabs below.

New to x402? Read the 5-minute quickstart →