Developers
API reference
The Bublate API lets a publisher or studio send chapters from its own systems: create a chapter, upload its pages, start translations and collect the lettered pages. Webhooks tell your server when a chapter is ready.
Keys
The workspace owner creates keys in the app: account menu, API and webhooks. A key acts as the owner of that workspace. It spends the workspace’s credits, at the same price as the app: 10 credits for each language of a webtoon chapter of up to 20 segments, and 5 more for each further 10 segments (how credits are counted). Manga and other print pages cost up to $0.60 a page. Bublate keeps only a hash of each key, so copy the key when you create it. Revoke a key in the same place.
Send the key in the Authorization header of every request:
Authorization: Bearer bub_...The base URL is https://bublate.com/api/v1. Requests and answers are JSON, except page uploads and file downloads. An error answers with an HTTP status and {"error": "..."}.
Translate a chapter
1. Create the chapter
POST /chapters with a new series title, or the id of a series you already have. srcLang is one of Korean, Japanese, Chinese or English. format is webtoon (vertical strips) or paged.
curl https://bublate.com/api/v1/chapters \
-H "Authorization: Bearer $BUBLATE_KEY" -H "Content-Type: application/json" \
-d '{"seriesTitle": "Moonlit Garden", "number": "12", "srcLang": "Korean", "format": "webtoon"}'
{"id": "8091246a-...", "seriesId": "778494dc-...", "uploadJob": "8c86d9b857c0"}2. Upload the pages
PUT /chapters/{id}/pages/{file} with the image as the body, one request per page. PNG, JPG or WebP, 30 MB at most per page. Pages are read in file name order, so name them 0001.jpg, 0002.jpg and so on.
curl -X PUT https://bublate.com/api/v1/chapters/8091246a-.../pages/0001.jpg \
-H "Authorization: Bearer $BUBLATE_KEY" -H "Content-Type: image/jpeg" \
--data-binary @0001.jpg
{"ok": true, "pages": 1}3. Start the translations
POST /chapters/{id}/start with the target languages. rights: true confirms that you own the work or have the rights to translate it. Each language becomes one version with its own id. An optional note (up to 1,000 characters) tells the translation about this chapter only, for example "Flashback: the lead is 8 here".
curl https://bublate.com/api/v1/chapters/8091246a-.../start \
-H "Authorization: Bearer $BUBLATE_KEY" -H "Content-Type: application/json" \
-d '{"targets": ["English", "Spanish"], "rights": true}'GET /chapters/{id}/quote answers the price of an uploaded chapter for each language (credits, unit, count) and balance, the credits the workspace can spend. Before an upload, POST /quote with {"pages": [{"width": 800, "height": 12000}, ...]} (sizes in pixels) gives an estimate. GET /me answers the workspace and its credits.
Target languages: English, Spanish, Portuguese (Brazil), Indonesian, Thai, Vietnamese, French, German, Japanese, Korean, Chinese (Traditional). A chapter takes about 10 minutes per language. Your workspace needs the chapter’s price in credits for each language, or the request answers 402. A started request answers credits (the credits it spent, the most the chapter costs), unit (segments for a strip, pages for print pages), count (the number the price came from) and segments. Credits that the chapter does not use come back after its pages are cut or read.
4. Check the status
GET /series lists your series. GET /series/{id}/chapters lists its chapters with their versions. GET /versions/{id} answers the status of one version: queued, translating, review (ready), done, exported or failed. A failed version gives its credits back.
{"id": "8c86d9b857c0", "lang": "English", "status": "review", "stage": "Visual check", "progress": 1, "flags": 3,
"files": [{"name": "seg000.png", "url": "/api/v1/versions/8c86d9b857c0/files/out-en/seg000.png",
"download": "https://bublate.com/api/v1/download/8c86d9b857c0/out-en/seg000.png?e=...&s=..."}, ...]}GET /versions lists the newest versions of the workspace, newest change first, with the series title and chapter number. Add ?status=review to get only the ready ones, and &limit= (1 to 100, default 20).
5. Download the pages
When the status is review or later, files lists the lettered segments in reading order. Download each url with the same key, or open its download link, which works without a key for one hour. flags counts the places the visual check asks a person to look at.
The files are the pipeline’s first pass. Edits made in the app editor (text styles, strokes, images) show in the app’s own export, not here. Open the chapter in the app to review and export the final release.
POST /versions/{id}/cancel stops a queued or running version and returns its credits. Once lettering starts, a version can no longer be cancelled.
Webhooks
Add an https endpoint in the app under API and webhooks, and pick its events. Bublate sends a POST with a JSON body when a version changes state:
| Event | When |
|---|---|
version.review | A translation is ready for review |
version.failed | A translation failed. Its credits are back |
version.done | Someone marked the version done in the editor |
version.exported | Someone exported the version |
POST https://example.com/bublate
x-bublate-event: version.review
x-bublate-signature: t=1794070400,v1=5f2c...
{"id": "e0c1...", "event": "version.review", "created": 1794070400,
"data": {"version": "8c86d9b857c0", "chapter": "8091246a-...", "lang": "English", "status": "review"}}Check the signature. v1 is the hex HMAC-SHA256 of {t}.{raw body} with your endpoint’s signing secret (whsec_..., shown once when you add the endpoint). Reject a request whose signature does not match or whose t is more than 5 minutes old.
import crypto from 'node:crypto'
function verify(rawBody, header, secret) {
const { t, v1 } = Object.fromEntries(header.split(',').map((p) => p.split('=')))
const mac = crypto.createHmac('sha256', secret).update(`${t}.${rawBody}`).digest('hex')
const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300
return fresh && crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(v1))
}Automation tools can add and remove endpoints with the key: GET /webhooks lists them, POST /webhooks with {"url": "https://...", "events": ["version.review"]} adds one and answers its id and secret once, and DELETE /webhooks/{id} removes it with its delivery log.
Answer with a 2xx status within 10 seconds. Bublate does not follow redirects. After 20 failed deliveries in a row the endpoint turns off. Turn it on again in the app. Send test sends a ping event.
MCP
Bublate is also a remote MCP server, so an assistant such as Claude, ChatGPT or Cursor can create chapters, upload pages, check prices, start translations and collect the files for you. The server URL is:
https://bublate.com/mcpSign in. Add the URL as a custom connector, and the assistant opens the Bublate sign-in page (OAuth). It then acts as your own account. A client that cannot sign in with OAuth can send an API key instead, in the Authorization: Bearer bub_... header. A key acts as the owner of its workspace, as above.
claude mcp add --transport http bublate https://bublate.com/mcp
# or with a key, in any client that takes headers:
{"mcpServers": {"bublate": {"type": "http", "url": "https://bublate.com/mcp",
"headers": {"Authorization": "Bearer bub_..."}}}}| Tool | What it does |
|---|---|
list_series, list_chapters | The series and chapters of the workspace, with each translation and its status |
list_recent_translations | The newest translations, for example only the ready ones |
quote_price | The price in credits per language, for an uploaded chapter or from page sizes |
create_chapter | A new chapter in a new or an existing series. Costs nothing |
add_pages | Pages from public https:// image links (30 MB a page) or as base64 data (5 MB a page, 16 MB a call). 20 pages per call, 1,000 pages a chapter |
start_translation | Starts the chapter in one or more languages and spends credits. The assistant must first ask you to confirm that you have the rights to the work |
get_translation_status | Status, stage and progress of one translation |
list_output_files | The lettered pages, with download links that work for one hour |
Read tools are marked read-only. start_translation is marked as a change that cannot be undone, so the assistant asks before it spends credits. The server speaks MCP 2026-07-28 and the earlier 2025-11-25, 2025-06-18 and 2025-03-26 versions over Streamable HTTP. It is listed in the MCP Registry as com.bublate/bublate. Discovery files: /.well-known/oauth-protected-resource/mcp, /.well-known/ai-catalog.json and /mcp/server-card.
Page links you give to add_pages must be public https:// addresses. Bublate fetches each image once, stores it with the chapter and does not follow more than 3 redirects.
Limits
- 20 keys and 10 webhook endpoints per workspace.
- Up to 20 chapters translate at the same time across all workspaces. More wait in a queue and start in order.
- A chapter holds 1,000 pages at most.
- Only work you own or have the rights to translate. See the Acceptable Use Policy.
Contact
Questions about the API, webhooks or the MCP server: email developers@bublate.com.