API Reference

接口参考

按接口拆分查看请求地址、输入参数、输出参数与错误代码。

Gateway Protocols多标准协议兼容
OpenAIAnthropicGeminiOpenRouter
Chat / Responses / Messages / Claude Messages
POST /v1/embeddings

向量 Embedding

同步生成文本向量。

接口信息

请求地址https://api.4stoken.cn
请求路径/v1/embeddings
请求方式POST
Content-Typeapplication/json
鉴权Authorization: Bearer sk-...

输入参数

参数类型必填说明
modelstringEmbedding 模型编码。
inputstring | string[]需要向量化的文本或文本数组。

输出参数

参数类型返回说明
objectstring固定为 list。
modelstring实际使用的模型。
data[].embeddingnumber[]向量结果。
data[].indexinteger输入文本对应下标。
usageobjecttoken 用量统计。

错误代码

HTTP 状态码错误说明
401UnauthorizedClient Key 无效或未提供。

示例

请求示例

{
  "model": "text-embedding-3-small",
  "input": "需要向量化的文本"
}

响应示例

{
  "object": "list",
  "model": "text-embedding-3-small",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0123, -0.0456, 0.0789]
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}