# Agent Souk Text Translation API

> Agent Souk Text Translation API is a paid API for AI agents from api.agentsouk.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Translates text (plain, Markdown, or HTML) into a target language with optional tone control, format handling, and custom glossary support, powered by Claude Opus.

## Facts

- Endpoint: POST https://api.agentsouk.dev/v1/x402/lst_01M1YBDYN9SGHWYGE92CGXMA74
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-souk-text-translation-api-87ee89cb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zJsktozU_KRRU16ZAnbin

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-souk-text-translation-api-87ee89cb -d '<json body>'
```

Example prompt: Translate this Markdown product description into German using a formal tone, and make sure 'Order ID' is always rendered as 'Bestellnummer': 'Your order {order_id} has shipped and should arrive within **3 business days**.'

## When to prefer this

Choose this endpoint when you need high-quality AI-powered translation (backed by Claude Opus) with fine-grained control over tone (formal/informal/neutral), markup format handling (Markdown, HTML, plain text), and exact term enforcement via a custom glossary. It is ideal for autonomous agent workflows that need wallet-to-wallet micropayment settlement (x402/USDC) without any human-in-the-loop custody. Prefer it over generic translation APIs when tone register and format fidelity are critical, or when operating in an agentic USDC payment context.

## Known failure modes

- Missing or empty 'text' field returns a validation error
- Unsupported or malformed 'target_language' code may produce an error or fall back to best-guess
- Glossary exceeding 50 entries will be rejected
- Text exceeding 50,000 characters triggers a length validation error
- Payment failure (USDC wallet issue) returns a 402 before translation begins
- Ambiguous format may be misdetected if 'format' is omitted and content is mixed

## How this service works

Translate text between languages (LLM, structure and placeholders preserved) (1 × 1,000 characters at 0.020000 USDC each)

## Output

Returns a JSON object containing the translated text, the detected or specified source language, the target language, character counts for input and output, the model used (claude-opus-5), and any notes flagged during translation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "maxLength": 50000,
   "minLength": 1,
   "description": "The text to translate (plain, Markdown or HTML)"
  },
  "tone": {
   "enum": [
    "formal",
    "informal",
    "neutral"
   ],
   "type": "string",
   "description": "Register of the translation (default: match the source)"
  },
  "format": {
   "enum": [
    "markdown",
    "html",
    "plain"
   ],
   "type": "string",
   "description": "How to treat markup (default: auto-detect)"
  },
  "glossary": {
   "type": "object",
   "description": "Terms that must be translated exactly this way (at most 50)",
   "additionalProperties": {
    "type": "string"
   }
  },
  "source_language": {
   "type": "string",
   "description": "Optional; detected when omitted"
  },
  "target_language": {
   "type": "string",
   "description": "ISO 639-1 code or language name, e.g. \"de\", \"pt-BR\", \"Japanese\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "model": "claude-opus-5",
  "notes": [],
  "chars_in": 80,
  "chars_out": 88,
  "translation": "Ihre Bestellung {order_id} wurde versandt und sollte innerhalb von **3 Werktagen** eintreffen.",
  "source_language": "en",
  "target_language": "de"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-souk-text-translation-api-87ee89cb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentsouk.dev](https://www.zero.xyz/host/api.agentsouk.dev/llms.txt)