创建文本嵌入
使用 ShareAI 生成文本嵌入,用于语义搜索、检索和相似性,支持的输入格式和模型要求。
本页面内容
POST
https://api.shareai.now/api/v1/embeddings将一个或多个文本转换为嵌入向量。
- 基础 URL
https://api.shareai.now- 身份验证
- Bearer API 密钥或已批准的 OAuth 访问令牌
选择一个在 ShareAI 上启用并由您的凭证允许的嵌入模型。聊天模型不能替代嵌入模型。模型的可用性和支持选项取决于配置的提供者。
发送请求#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/embeddings" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_EMBEDDING_MODEL",
"input": [
"How do I connect a device?",
"Where can I read my usage?"
],
"encoding_format": "float"
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_EMBEDDING_MODEL', 'input': ['How do I connect a device?', 'Where can I read my usage?'], 'encoding_format': 'float'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/embeddings', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/embeddings";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_EMBEDDING_MODEL",
"input": [
"How do I connect a device?",
"Where can I read my usage?"
],
"encoding_format": "float"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
请求字段#
| 字段 | 价值 |
|---|---|
model | 一个启用的嵌入模型 ID。 |
input | 一个非空字符串或最多 128 个非空字符串的数组。 |
encoding_format | float 或 base64. |
dimensions | 可选整数范围为 1 到 65536;所选模型必须支持此范围。 |
读取向量#
阅读 data 数组并使用每个结果的 index 来匹配其嵌入与输入。嵌入您的文档和搜索查询时保持相同的模型和维度。结果还包括提供者报告的 usage.
在限制范围内批量处理#
合并输入文本限制为 256 KiB。响应是同步的,限制为 2 MiB,因此较大的向量或批处理可能会超出响应限制。减少批处理大小或使用支持的较小维度。不接受 Token-ID 数组。
身份验证和可用性#
一个批准的 OAuth 访问令牌可以替代 API 密钥。账户资助的请求需要 surcharge 和一个已接受的计划。模型和提供者限制仍然适用。如果模型未启用嵌入,请选择一个可用的嵌入模型;更改凭证无法启用模型。
使用情况#
嵌入会消耗输入令牌。在运行大批量之前检查模型定价并使用 控制台使用情况 来查看活动。在重试之前处理验证、授权和可用性错误。
最近更新于 9 月 15, 2026