- base64hub
- Документация
- HTTP API
- Кодирование
POSTКодирование
Превращает текст или байты в Base64. Стандартный или URL-safe алфавит, с дополнением или без, при желании с переносом строк.
https://api.base64hub.com/v1/encodeЗапрос
Отправьте JSON с текстом в input. Текст кодируется как UTF-8.
curl -s https://api.base64hub.com/v1/encode \
-H 'Content-Type: application/json' \
-d '{"input": "Hello, hub!"}'
const res = await fetch("https://api.base64hub.com/v1/encode", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ input: "Hello, hub!" }),
});
const { output } = await res.json();
console.log(output); // SGVsbG8sIGh1YiE=
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/encode",
data=json.dumps({"input": "Hello, hub!"}).encode(),
headers={"Content-Type": "application/json"},
)
with urllib.request.urlopen(req) as res:
print(json.load(res)["output"]) # SGVsbG8sIGh1YiE=
b64 "Hello, hub!"
# SGVsbG8sIGh1YiE=
Параметры тела
| Имя | Тип | Описание |
|---|---|---|
input обязательный | string | Текст для кодирования. Сначала он переводится в байты UTF-8. |
variant необязательный | "standard" или "url" | Алфавит. url использует - и _ вместо + и /. По умолчанию "standard". |
padding необязательный | boolean | Оставлять = в конце. По умолчанию true. |
wrap необязательный | integer, от 0 до 1000 | Вставлять \n после каждых N символов результата, но не в конце. 76 – MIME. По умолчанию 0, без переноса. |
Любое другое поле отклоняется с 400 invalid_body.
Сырые байты
Чтобы закодировать файл или любые бинарные данные, отправьте байты как application/octet-stream. Параметры тогда передаются в строке запроса: variant=url, padding=false, wrap=76.
printf '\xfb\xff\xbf' | curl -s \
'https://api.base64hub.com/v1/encode?variant=url&padding=false' \
-H 'Content-Type: application/octet-stream' \
--data-binary @-
const bytes = new Uint8Array([0xfb, 0xff, 0xbf]);
const res = await fetch(
"https://api.base64hub.com/v1/encode?variant=url&padding=false",
{ method: "POST", headers: { "Content-Type": "application/octet-stream" }, body: bytes },
);
console.log((await res.json()).output); // -_-_
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/encode?variant=url&padding=false",
data=b"\xfb\xff\xbf",
headers={"Content-Type": "application/octet-stream"},
)
with urllib.request.urlopen(req) as res:
print(json.load(res)["output"]) # -_-_
printf '\xfb\xff\xbf' | b64 --url --no-pad
# -_-_
Тело ограничено 1 МБ. Для файлов побольше используйте CLI, который работает потоково.
Ответ
{
"output": "SGVsbG8sIGh1YiE=",
"variant": "standard",
"padding": true,
"bytes_in": 11,
"bytes_out": 16
}
| Поле | Тип | Описание |
|---|---|---|
output | string | Текст Base64. |
variant | string | Использованный алфавит, standard или url. |
padding | boolean | Сохранено ли дополнение =. |
bytes_in | integer | Число входных байтов после перевода в UTF-8. |
bytes_out | integer | Длина output вместе с переводами строк. |
С {"input": "foobar", "wrap": 4} результат равен "Zm9v\nYmFy", а bytes_out равно 9: восемь символов Base64 и один перевод строки. Ответ выше отформатирован для удобства чтения; API присылает его одной строкой.
Ошибки
| Статус | Код | Причина |
|---|---|---|
| 400 | invalid_body | Некорректный JSON, input отсутствует или не строка, неверные variant, padding или wrap, неизвестное поле или параметр строки запроса либо параметры в строке запроса вместе с телом JSON. |
| 413 | too_large | Тело больше 1 МБ. |
| 415 | unsupported_media_type | Content-Type не application/json и не application/octet-stream. |
| 429 | нет | Достигнут лимит запросов; см. лимиты. |
Все ошибки перечислены в обзоре API.
Обновлено 22 нояб. 2026 г.