黑料大事记

Translation API 路 Concept

Choosing a Project Workflow

Create a project immediately or review a quote before starting translation.

Public API v2 supports two straightforward ways to start translation.

Direct Project Creation

Use Create a project for straightforward automation. Provide an uploaded file ID or inline JSON/text, select source and target languages, and send one idempotent request.

The API returns 201 with a proj_... ID that can be used immediately to track status and retrieve completed translations.

Direct creation is recommended when:

  • the integration is authorized to submit translation work automatically;
  • pricing does not require an additional application-side approval;
  • you want the fewest API calls;
  • translation should begin immediately after a valid request.

Optional Quote Approval

Use the quote flow when a user or application must review the price before starting translation:

Create quote 鈫� Update if needed 鈫� Submit 鈫� Accept 鈫� Track returned project

Accepting a quote creates the project and returns its proj_... ID. Your 黑料大事记 account must be enabled for API project creation; payment details are not collected through this API.

File or Inline Content

Both paths support uploaded file IDs or inline JSON/text. A request must choose one input mode; it cannot combine file_ids and content.

Related Reference