XRToken API 文档

文本向量化

API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net

兼容 OpenAI SDK,input 支持字符串或字符串数组,最多 128 条;批量输入逐条返回向量,保持输入顺序。 国内模型:volcengine/doubao-embedding-vision-251215,兼容别名 volcengine/doubao-embedding-vision。 海外模型:volcengine-overseas/skylark-embedding-vision-251215。 按上游实际用量分别计算文本、视觉输入 token 费用,并应用账号折扣。 携带 API Key 调用 GET /v1/models 查询价格;视觉输入单价字段为 embedding_visual_input_per_1m,单位为本站币种/百万 token。 无输出 token 费用;上游失败或响应缺少有效向量、用量时释放预冻结金额。 旧模型 doubao-embedding、doubao-embedding-large 已下架。不同模型的向量空间不同,切换模型时需重建已有向量索引。 同时支持 /api/v3、/v3、/api/v1 前缀。不支持流式输出和预分词整数输入。

POST
/v1/embeddings

Authorization

BearerAuth
AuthorizationBearer <token>

API 密钥认证(OpenAI 格式)。在 Authorization 请求头中传入:

Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X post "https://api.xrtoken.net/v1/embeddings" \  -H "Content-Type: application/json" \  -d '{    "model": "volcengine/doubao-embedding-vision-251215",    "input": [      "semantic search",      "vector retrieval"    ]  }'
{
  "model": "string",
  "object": "string",
  "data": [
    {}
  ],
  "usage": {
    "prompt_tokens": 0,
    "total_tokens": 0,
    "prompt_tokens_details": {}
  }
}
Empty
Empty
Empty
Empty
Empty
Empty