向量

托管向量存储（RAG）：集合与 upsert/query/delete，默认自研 pgvector。

概览

基础路径: https://api.infrai.cc/v1/vector

鉴权头: Authorization: Bearer $INFRAI_API_KEY

bash

# Call any /v1/vector capability over raw HTTP — no SDK to install.
# curl:
curl https://api.infrai.cc/v1/vector/... \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json"

方法

vector.collection.create

POST /v1/vector/collection/create

创建向量集合（命名空间）：指定向量维度与距离度量，作为 RAG 向量的容器。默认自研 pgvector；免费管理操作。

参数

名称	类型	必填	说明
`collection`	`string`	必填	集合（命名空间）名称。
`dimension`	`number`	必填	向量维度（创建时必填；须与写入的 embedding 维度一致）。
`metric`	`"cosine" \| "euclidean" \| "dotproduct"`	可选	距离度量：cosine（默认）、euclidean 或 dotproduct。
`idempotency_key`	`string`	可选	可选去重 key；相同重试将返回同一结果。

Collection { collection, dimension, metric, vector_count, state }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X POST https://api.infrai.cc/v1/vector/collection/create \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection": "...", "dimension": 0}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/vector/collection/create",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'collection': '...', 'dimension': 0},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/create",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "dimension": 0}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/create",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "dimension": 0}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

vector.upsert

POST /v1/vector/upsert

向集合写入/更新向量（id+embedding+metadata）。ai.embed → vector.upsert 一条龙完成 RAG 入库。计费工作动作。

参数

名称	类型	必填	说明
`collection`	`string`	必填	集合（命名空间）名称。
`vectors`	`Array<{ id, embedding: number[], metadata? }>`	必填	待写入的向量：每条包含 id、embedding（number[]）及可选 metadata。
`idempotency_key`	`string`	可选	可选去重 key；相同重试将返回同一结果。

UpsertResult { collection, upserted }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X POST https://api.infrai.cc/v1/vector/upsert \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection": "...", "vectors": []}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/vector/upsert",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'collection': '...', 'vectors': []},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/upsert",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "vectors": []}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/upsert",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "vectors": []}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

vector.query

POST /v1/vector/query

对集合做近似最近邻（ANN）相似检索，返回 top-k 最近向量及分数与 metadata。计费工作动作。

参数

名称	类型	必填	说明
`collection`	`string`	必填	集合（命名空间）名称。
`embedding`	`number[]`	必填	查询向量——返回与该点最近的若干向量。
`top_k`	`number`	可选	返回的最近邻数量（默认 10）。
`filter`	`Record<string, unknown>`	可选	相似检索前应用的可选 metadata 过滤条件。

QueryResult { collection, matches: Array<{ id, score, metadata? }> }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X POST https://api.infrai.cc/v1/vector/query \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection": "...", "embedding": []}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/vector/query",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'collection': '...', 'embedding': []},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/query",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "embedding": []}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/query",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "embedding": []}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

vector.collection.get

GET /v1/vector/collection/get

获取向量集合配置（维度、度量、向量数）。免费管理读。

参数

名称	类型	必填	说明
`collection`	`string`	必填	集合（命名空间）名称。

Collection { collection, dimension, metric, vector_count, state }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X GET https://api.infrai.cc/v1/vector/collection/get \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/vector/collection/get",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/get",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/get",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

vector.collection.list

GET /v1/vector/collection/list

列出账户的向量集合。免费管理读。

{ collections: Collection[] }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X GET https://api.infrai.cc/v1/vector/collection/list \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/vector/collection/list",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

vector.collection.delete

DELETE /v1/vector/collection/delete

删除向量集合及其全部向量。免费管理（幂等）。

参数

名称	类型	必填	说明
`collection`	`string`	必填	集合（命名空间）名称。
`idempotency_key`	`string`	可选	可选去重 key；相同重试将返回同一结果。

CollectionDeleteResult { collection, deleted }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X DELETE https://api.infrai.cc/v1/vector/collection/delete \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.delete(
    "https://api.infrai.cc/v1/vector/collection/delete",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/delete",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/delete",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

vector.delete

DELETE /v1/vector/delete

按 id 从集合删除指定向量。免费管理。

参数

名称	类型	必填	说明
`collection`	`string`	必填	集合（命名空间）名称。
`ids`	`string[]`	必填	要从集合中删除的向量 id。
`idempotency_key`	`string`	可选	可选去重 key；相同重试将返回同一结果。

DeleteResult { collection, deleted }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X DELETE https://api.infrai.cc/v1/vector/delete \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.delete(
    "https://api.infrai.cc/v1/vector/delete",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/delete",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/vector/delete",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

全部能力

本模块全部已路由能力——完整的对外 REST 契约。上方方法是带讲解的入门示例,此表是完整参考。

能力	端点	说明
`vector.collection.create`	`POST /v1/vector/collection/create`	Create a vector collection (namespace) for an embedding dimension and distance metric — the container for RAG vectors. Self-hosted on pgvector by default; free management.
`vector.collection.delete`	`DELETE /v1/vector/collection/delete`	Delete a vector collection and all its vectors. Free management (idempotent).
`vector.collection.get`	`GET /v1/vector/collection/get`	Fetch a vector collection's configuration (dimension, metric, vector count). Free management read.
`vector.collection.list`	`GET /v1/vector/collection/list`	List the account's vector collections. Free management read.
`vector.delete`	`DELETE /v1/vector/delete`	Delete specific vectors by id from a collection. Free management.
`vector.query`	`POST /v1/vector/query`	Run an approximate nearest-neighbor (ANN) similarity search over a collection, returning the top-k closest vectors with scores and metadata. Billable work-action.
`vector.upsert`	`POST /v1/vector/upsert`	Insert or update vectors (id + embedding + metadata) into a collection. Pair ai.embed → vector.upsert for one-stop RAG ingestion. Billable work-action.

完整示例

本模块的生产级端到端范例:先一次性配置,再运行业务流程,尽量覆盖本模块的多数 API。

单文件可运行 Python 程序(仅标准库、无 SDK):拷贝后填入 INFRAI_API_KEY 运行,即可按真实业务流逐步体验本模块核心 API——每一步都真实调用并计费,后续步骤复用前一步返回的真实字段。12 行 helper 就是全部集成代码。

python

#!/usr/bin/env python3
"""Infrai · vector — runnable real-app example (single file, zero deps).

Copy this file, set your key, run it: every step is a REAL call to
api.infrai.cc, billed at the real (tiny) per-call price, printing the
live JSON response. Get a key at https://infrai.cc/login (Google/
GitHub sign-in grants $2 free credit); add funds at
https://infrai.cc/billing. No SDK — the 12-line helper below is the
entire integration."""
import json
import os
from urllib import error, request

KEY = os.environ.get("INFRAI_API_KEY") or "ifr_..."  # <- your key
BASE = "https://api.infrai.cc"


# Same raw HTTPS POST/GET as every per-method example on this page —
# wrapped once for reuse. There is nothing else to it: no SDK.
def infrai(method, path, body=None):
    req = request.Request(
        BASE + path, method=method,
        data=json.dumps(body).encode() if body is not None else None,
        headers={"Authorization": f"Bearer {KEY}",
                 "Content-Type": "application/json"})
    try:
        with request.urlopen(req, timeout=60) as r:
            return json.loads(r.read())
    except error.HTTPError as e:
        return json.loads(e.read())


def show(label, resp):
    print(f"\n== {label} ==")
    print(json.dumps(resp, indent=2, ensure_ascii=False))
    return resp


# 1) vector.collection.create — POST /v1/vector/collection/create · Create a vector collection (namespace) for an embedding dimension and distance metric — the container for RAG vectors. Self-hosted on pgvector by default; free management.
r1 = show("vector.collection.create", infrai("POST", "/v1/vector/collection/create", {"collection":"docs","dimension":3,"metric":"cosine"}))

# 2) vector.upsert — POST /v1/vector/upsert · Insert or update vectors (id + embedding + metadata) into a collection. Pair ai.embed → vector.upsert for one-stop RAG ingestion. Billable work-action.
r2 = show("vector.upsert", infrai("POST", "/v1/vector/upsert", {"collection":"docs","vectors":[{"id":"a","embedding":[0.1,0.2,0.3],"metadata":{"title":"intro"}}]}))

# 3) vector.query — POST /v1/vector/query · Run an approximate nearest-neighbor (ANN) similarity search over a collection, returning the top-k closest vectors with scores and metadata. Billable work-action.
r3 = show("vector.query", infrai("POST", "/v1/vector/query", {"collection":"docs","embedding":[0.1,0.2,0.3],"top_k":3}))

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

# 1) Auth: every call is a raw HTTPS request to the Infrai gateway carrying
#    only your project key. No SDK, no install.
#    Get your key: sign in with Google/GitHub at https://infrai.cc/login for a
#    project key + $2 free credit (email sign-in starts at $0). On 402
#    INSUFFICIENT_CREDIT, add funds at https://infrai.cc/billing (or POST
#    /v1/account/topup and open the returned checkout_url).
export INFRAI_API_KEY="ifr_..."   # from https://infrai.cc/login


# 2) vector.collection.create
curl -X POST https://api.infrai.cc/v1/vector/collection/create \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection": "...", "dimension": 0}'

# 3) vector.upsert
curl -X POST https://api.infrai.cc/v1/vector/upsert \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection": "...", "vectors": []}'

# 4) vector.query
curl -X POST https://api.infrai.cc/v1/vector/query \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection": "...", "embedding": []}'

# 5) vector.collection.get
curl -X GET https://api.infrai.cc/v1/vector/collection/get \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 6) vector.collection.list
curl -X GET https://api.infrai.cc/v1/vector/collection/list \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 7) vector.collection.delete
curl -X DELETE https://api.infrai.cc/v1/vector/collection/delete \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 8) vector.delete
curl -X DELETE https://api.infrai.cc/v1/vector/delete \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

# 1) Auth: every call is a raw HTTPS request carrying only your project key.
#    No SDK to install — just the `requests` library.
import os, requests

BASE = "https://api.infrai.cc"
HEADERS = {
    "Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}",
    "Content-Type": "application/json",
}


# 2) vector.collection.create
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/vector/collection/create",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'collection': '...', 'dimension': 0},
)
resp.raise_for_status()
print(resp.json())

# 3) vector.upsert
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/vector/upsert",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'collection': '...', 'vectors': []},
)
resp.raise_for_status()
print(resp.json())

# 4) vector.query
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/vector/query",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'collection': '...', 'embedding': []},
)
resp.raise_for_status()
print(resp.json())

# 5) vector.collection.get
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/vector/collection/get",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 6) vector.collection.list
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/vector/collection/list",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 7) vector.collection.delete
import os, requests

resp = requests.delete(
    "https://api.infrai.cc/v1/vector/collection/delete",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 8) vector.delete
import os, requests

resp = requests.delete(
    "https://api.infrai.cc/v1/vector/delete",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

// 1) Auth: every call is a raw HTTPS request carrying only your project key.
//    No SDK to install — just the built-in fetch().
const BASE = "https://api.infrai.cc";
const HEADERS = {
  "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
  "Content-Type": "application/json",
};


// 2) vector.collection.create
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/create",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "dimension": 0}),
  },
);
console.log(await resp.json());

// 3) vector.upsert
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/upsert",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "vectors": []}),
  },
);
console.log(await resp.json());

// 4) vector.query
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/query",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "embedding": []}),
  },
);
console.log(await resp.json());

// 5) vector.collection.get
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/get",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 6) vector.collection.list
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 7) vector.collection.delete
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/delete",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 8) vector.delete
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/delete",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

// 1) Auth: every call is a raw HTTPS request carrying only your project key.
//    No SDK to install — just the built-in fetch(), typed.
const BASE = "https://api.infrai.cc";
const HEADERS: Record<string, string> = {
  "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
  "Content-Type": "application/json",
};


// 2) vector.collection.create
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/create",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "dimension": 0}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 3) vector.upsert
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/upsert",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "vectors": []}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 4) vector.query
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/query",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"collection": "...", "embedding": []}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 5) vector.collection.get
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/get",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 6) vector.collection.list
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 7) vector.collection.delete
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/collection/delete",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 8) vector.delete
const resp = await fetch(
  "https://api.infrai.cc/v1/vector/delete",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);