Skip to content

创建嵌入

概览

  • 请求方法:POST
  • 路径:/v1/embeddings
  • 内容类型:application/json

认证

  • 使用 HTTP Bearer Token,示例:Authorization: Bearer sk-xxxxx

请求参数

参数类型必填描述
modelstring要使用的模型 ID,例如 text-embedding-3-large(参见模型列表)
inputstring | array[string]要编码为嵌入的文本。可传单个字符串或字符串数组(每项长度受限,详见模型说明)

请求示例

单输入示例:

json
{
  "model": "text-embedding-3-large",
  "input": "她长得非常漂亮,喜欢..."
}

批量输入示例:

json
{
  "model": "text-embedding-3-large",
  "input": [
    "文本 A",
    "文本 B"
  ]
}

curl

bash
curl -X POST "https://api.gpt.ge/v1/embeddings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model":"text-embedding-3-large","input":"她长得非常漂亮,喜欢..."}'

JavaScript (fetch)

javascript
fetch('https://api.gpt.ge/v1/embeddings', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer sk-xxxx' },
  body: JSON.stringify({ model: 'text-embedding-3-large', input: '她长得非常漂亮,喜欢...' })
}).then(r => r.json()).then(console.log)

Python (requests)

python
import requests

payload = { 'model': 'text-embedding-3-large', 'input': '她长得非常漂亮,喜欢...' }
resp = requests.post('https://api.gpt.ge/v1/embeddings', headers={'Content-Type':'application/json','Authorization':'Bearer sk-xxxx'}, json=payload)
print(resp.json())

返回示例(200)

json
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        -0.022425562,
        -0.010263717,
        0.022136442,
        0.015323295,
        -0.0013466021
      ]
    }
  ],
  "model": "text-embedding-3-large",
  "usage": { "prompt_tokens": 16, "total_tokens": 16 }
}