Translation: Order a job, or get the offer: the price and the exact next call.

`order_translation`

POST /jobs

Translation: send a document and a language; get a document back. $49 per job, within 48 hours, charged on delivery. AI delivers every job.

Parameters

servicestringrequired

The Service to order: "translation".

documentobject · filerequired

Show 2 child keys

urlstring · urirequired

namestringrequired

tostring · languagerequired

a BCP 47 tag, such as fr-CA

Left out, the 400 names it as the field to fill.

max_usdnumber

The most you will pay, in dollars. Missing or below the price, you get an offer instead of a job.

keystring

Any string you choose. Retrying with the same key returns the same job.

metadataobject

Your own keys, echoed on the job and its events.

test_clockstring

A test clock the job runs on: tc_….

Returns

Request

$ npx services.dev translation document=document.pdf to=fr-CA service=translation
OFFER · $49 per job, within 48 hours, charged on delivery.
  next    npx services.dev translation document=document.pdf to=fr-CA --max 49

$ npx services.dev translation document=document.pdf to=fr-CA --max 49
job_7Hq2 · working · $49.00 held

curl http://localhost:8787/jobs \
  -H 'content-type: application/json' \
  -d '{"service":"translation","document":{"url":"https://example.com/document.pdf","name":"document.pdf"},"to":"fr-CA","max_usd":49,"key":"any-string-you-choose"}'

→ order_translation {document: document.pdf, to: "fr-CA", key: "lease-fr-CA"}
← OFFER · $49 per job, within 48 hours, charged on delivery.
  next: order_translation {document: document.pdf, to: "fr-CA", max_usd: 49, key: "lease-fr-CA"}
→ order_translation {document: document.pdf, to: "fr-CA", max_usd: 49, key: "lease-fr-CA"}
← job_7Hq2 · working · $49.00 held

// A buyer that is software: it reads lingua's card, asks the price, orders when the price fits
// its budget, waits for delivery and accepts. Run it beside `npx services.dev dev`.
import { connect } from 'services.dev/agent'
import translation from './services/translation.ts'

const lingua = connect('http://localhost:8787', { budget: 100 })
const lease = { url: 'https://example.com/lease.pdf', name: 'lease.pdf' }

const job = await lingua.order(translation, { document: lease, to: 'fr-CA' })
if (!('done' in job)) throw new Error(job.type === 'OFFER' ? job.price.sentence : job.reason)

const done = await job.done()
if (done.status !== 'delivered') throw new Error(`${done.id} ${done.status}`)
console.log(`${done.id} · delivered · ${done.output.document.name}`)

await job.accept()
console.log(`${done.id} · accepted · spent $${lingua.spent} of $100`)

Response

{
  "id": "job_7Hq2",
  "object": "job",
  "created": "2026-10-25T14:00:02.000Z",
  "livemode": false,
  "simulated": true,
  "service": "translation",
  "input": {
    "document": {
      "url": "https://example.com/document.pdf",
      "name": "document.pdf"
    },
    "to": "fr-CA"
  },
  "metadata": {},
  "price": {
    "usd": 49,
    "approved": false,
    "max_usd": 49
  },
  "payment": {
    "status": "held",
    "amount_usd": 49
  },
  "human": "AI delivers every job.",
  "stage": null,
  "steps": [
    {
      "id": "stp_1",
      "object": "step",
      "step": "draft",
      "by": "ai",
      "status": "working"
    },
    {
      "id": "stp_2",
      "object": "step",
      "step": "review",
      "by": "ai",
      "review": "adversarial",
      "status": "pending"
    }
  ],
  "next": [
    {
      "do": "get",
      "arguments": {
        "id": "job_7Hq2"
      },
      "tool": "get_job",
      "http": "GET http://localhost:8787/jobs/job_7Hq2?wait=50"
    },
    {
      "do": "cancel",
      "arguments": {
        "id": "job_7Hq2"
      },
      "tool": "cancel_job",
      "http": "POST http://localhost:8787/jobs/job_7Hq2/cancel"
    }
  ],
  "status": "working"
}

job_7Hq2 · working · $49.00 held

captured at build · dev() seed 7Hq2 · services.dev 0.3.0