Translation APIReference
v2.0.0

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 Stepes 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