# text-embeddings-vector-api

> text-embeddings-vector-api is a paid API for AI agents from obol-x402.fly.dev, paid per call via x402, $0.002/call, status down (last checked 2026-09-15).

Generates 768-dimensional text embeddings (nomic-embed-text model) on self-hosted GPU, returning OpenAI-shaped [{index, embedding}] vectors for single or batch (up to 16) inputs, cryptographically signed with Ed25519.

## Facts

- Endpoint: GET https://obol-x402.fly.dev/v1/ai/embed
- Price: $0.002/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/text-embeddings-vector-api-bbf9c166
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DCcPPaS7F0LCGxlUye-Wc

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 text-embeddings-vector-api-bbf9c166
```

Example prompt: Embed this text for me so I can store it in my vector database: 'The quick brown fox jumps over the lazy dog' — I need a 768-dim nomic-embed-text vector, cryptographically signed.

## When to prefer this

Choose this endpoint when you need 768-dim nomic-embed-text vectors without signing up for an API key or account, want cryptographically verifiable (Ed25519-signed) embeddings, need to batch up to 16 texts in a single flat-price call ($0.002 USDC), or require embeddings computed on a self-hosted GPU with no third-party data forwarding. Prefer over OpenAI embeddings when privacy or auditability of inference is a concern, or when integrating into an x402 micropayment workflow.

## Known failure modes

- Missing or empty 'text' query param on GET returns error
- Batch exceeds 16 texts — rejected with error
- Payment not provided or insufficient USDC — 402 Payment Required
- Invalid input type or schema mismatch — 400 Bad Request
- GPU inference timeout on very long inputs
- Signature verification failure if pubkey endpoint is unavailable

## How this service works

Text embeddings over x402 — nomic-embed-text (768-dim) on OUR OWN GPU, never forwarded to a third-party API. OpenAI-shaped data[{index, embedding}] response; batch up to 16 texts in ONE flat-price call. For RAG, semantic search, dedup and memory pipelines. No API key, no account. GET ?text= or POST {input:[...]}. Free: GET /v1/ai/embed/preview. Cryptographically signed (Ed25519) — every response is independently verifiable via /.well-known/obol-pubkey.

## Output

Returns an OpenAI-shaped JSON array of objects [{index: number, embedding: number[768]}], one per input text. Each response is cryptographically signed with Ed25519 (verifiable via /.well-known/obol-pubkey). Inference runs on the provider's own GPU — nomic-embed-text model, 768 dimensions per vector.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "text"
     ],
     "properties": {
      "text": {
       "type": "string",
       "description": "string to embed (GET ?text=… — or POST input as string[] for batch, max 16)"
      }
     }
    }
   },
   "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/text-embeddings-vector-api-bbf9c166/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from obol-x402.fly.dev](https://www.zero.xyz/host/obol-x402.fly.dev/llms.txt)