协议接入
OpenAI Embeddings

OpenAI Embeddings

当你要生成向量嵌入时,使用:

POST /v1/embeddings

最小示例

curl -sS "https://api.4tk.ai/v1/embeddings" \
  -H "Authorization: Bearer YOUR_SUB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "你好,帮我生成一段检索向量"
  }'

多模态输入

如果所选 Embeddings 模型支持多模态向量输入,可以直接传官方兼容的数组结构,例如:

{
  "model": "YOUR_EMBEDDING_MODEL",
  "input": [
    {"type": "input_text", "text": "一张蓝色跑车"},
    {"type": "input_image", "image_url": "https://example.com/car.jpg"}
  ]
}

网关只校验 model 和 input,其余字段会继续透传上游。当前仅支持非流式返回。

适用场景

  • 向量检索、RAG、召回、相似度搜索
  • 需要与 OpenAI SDK 的 Embeddings 调用方式保持兼容
  • 希望直接复用文本或多模态嵌入请求体

注意事项

  • 当前不支持 stream=true;若传入会直接返回 400。
  • 模型名必须以 模型价格 或控制台实际展示的名称为准。
  • 多模态中的远程图片地址需要上游能够访问;不可访问的资源会在上游阶段失败。