# Citiview BGE-M3 Embeddings

> Citiview BGE-M3 Embeddings is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-14).

Generates multilingual text embeddings (1024-dimensional BGE-M3 vectors) for up to 100 text inputs per call, using an OpenAI-compatible API shape.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/embeddings?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-bge-m3-embeddings-0690c4dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WHLuQimqmhoAtYXAlU9p0

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 citiview-bge-m3-embeddings-0690c4dd
```

Example prompt: Embed the following sentence into a 1024-dimensional vector using BGE-M3: 'The quick brown fox jumps over the lazy dog' — return it as a float array.

## When to prefer this

Choose this endpoint when you need OpenAI-compatible embeddings without an OpenAI API key, want multilingual coverage across 100+ languages with a single model, prefer pay-per-call pricing with no subscription, or need to swap in a drop-in replacement for /v1/embeddings in an existing OpenAI SDK integration. BGE-M3's 1024-dimensional output is well-suited for dense retrieval and reranking tasks.

## Known failure modes

- Missing 'input' parameter returns a validation error
- More than 100 inputs in a single call may be rejected
- Invalid encoding_format value falls back to float silently or errors
- Payment not provided or insufficient USDC causes 402 Payment Required
- GET requests with very long input strings may hit URL length limits — use POST for large inputs
- Network timeout if the model is cold-starting

## How this service works

OpenAI-compatible embeddings endpoint (bge-m3, 1024 dimensions, 100+ languages): same request and response shape as OpenAI /v1/embeddings, including encoding_format base64. Up to 100 inputs per call, flat price, no API key: point any OpenAI SDK at https://agents.citiviewgroup.com/v1 and pay per request with x402. Priced by size and model: $0.003 + 3x the model token cost (bge-m3 is cheapest). Also callable as GET with the same fields as query parameters.

## Output

Returns a JSON object in OpenAI /v1/embeddings response format: an array of embedding objects each containing an index, the embedding vector (as a float array or base64-encoded string depending on encoding_format), and object type 'embedding', plus a usage object with token counts and the model name 'bge-m3'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "input"
     ],
     "properties": {
      "input": {
       "type": "string",
       "description": "Text to embed (POST also accepts an array of up to 100 strings)"
      },
      "model": {
       "type": "string",
       "description": "Ignored; always bge-m3"
      },
      "encoding_format": {
       "type": "string",
       "description": "float (default) | base64"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-bge-m3-embeddings-0690c4dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)