# Delx Commerce — Multilingual Text Ranking API

> Delx Commerce — Multilingual Text Ranking API is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-02).

Ranks a list of candidate texts against a multilingual query using semantic similarity scoring, returning candidates ordered by relevance score.

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/rank-multilingual-texts?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-multilingual-text-ranking-api-21f24119
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1Mrfnd4tOyIGOKFPid52v

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 delx-commerce-multilingual-text-ranking-api-21f24119 -d '<json body>'
```

Example prompt: Rank these 4 candidate answers by how well they match the question 'What are the symptoms of diabetes?' — the candidates are in English, French, Spanish, and German — and tell me which one is most relevant with its score.

## When to prefer this

Choose this endpoint when you need semantic relevance ranking across multiple languages without building or hosting your own embedding model. It is ideal for multilingual RAG pipelines, cross-lingual FAQ retrieval, or reranking search results where candidates may span languages. Prefer it over monolingual rankers when your corpus or users are multilingual. The pay-per-call model ($0.003 USDC, no signup) is optimal for agent workflows with variable or unpredictable load, and the verifiable SHA256 delivery and stored ranking URL make it suitable for auditable pipelines.

## Known failure modes

- Fewer than 2 or more than 16 candidates returns a validation error
- Query or candidate text exceeds character limits (1000 / 2000 chars) causes rejection
- Duplicate candidate texts rejected due to uniqueItems constraint
- Payment failure via x402 if USDC balance is insufficient
- Upstream Replicate model unavailability causes 502/503 errors
- Empty or null query string fails schema validation

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

A JSON object containing a ranked array of candidate objects, each with a floating-point similarity score and the original zero-based candidate_index. Also includes the model name (multilingual-e5-large), a SHA256 hash of the result for verifiability, a URL to retrieve the stored ranking, input SHA256, generation ID, candidate count, sale price in USDC, and cost breakdown.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "maxLength": 1000,
   "minLength": 1,
   "description": "The multilingual search question or intent to rank against."
  },
  "candidates": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 2000,
    "minLength": 1
   },
   "maxItems": 16,
   "minItems": 2,
   "description": "Unique candidate texts; returned by original zero-based index.",
   "uniqueItems": true
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "model": "beautyyuyanli/multilingual-e5-large",
  "ranked": [
   {
    "score": 0.912314,
    "candidate_index": 1
   },
   {
    "score": 0.134221,
    "candidate_index": 0
   }
  ],
  "sha256": "2d6c7c2b3f3c8e1e7b0d3a5b6e7f8a9b1234567890abcdef1234567890abcdef",
  "provider": "replicate",
  "media_type": "application/json",
  "ranking_url": "https://api.delx.ai/api/v1/generated-rankings/ranking-example.json",
  "input_sha256": "34a8815e9c57e321194d50f2ea8b64394019fb8038c9aefd7a9a306a5030fc31",
  "generation_id": "ranking-example-generation-id",
  "candidate_count": 2,
  "sale_price_usdc": 0.003,
  "gross_margin_usd": 0.002025,
  "upstream_cost_usd": 0.000975
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-commerce-multilingual-text-ranking-api-21f24119/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)