임베딩 (Embedding-3)

시맨틱 검색 및 텍스트 유사도 계산을 위한 텍스트 임베딩 인터페이스.

API 엔드포인트

POST/embeddings

텍스트 임베딩

요청 파라미터

파라미터	유형	필수	설명
`model`	string	필수	모델명: Embedding-3
`input`	string \| array	필수	임베딩할 텍스트 또는 텍스트 배열

요청 예시

{
  "model": "Embedding-3",
  "input": "智谱AI是一家专注于大模型的公司"
}

응답 예시

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "embedding": [0.123, -0.456, 0.789, ...],
      "index": 0
    }
  ],
  "model": "Embedding-3",
  "usage": {
    "prompt_tokens": 10,
    "total_tokens": 10
  }
}

코드 예시

Python

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://your-proxy-domain.com/v1"
)

response = client.embeddings.create(
    model="Embedding-3",
    input="智谱AI是一家专注于大模型的公司"
)

embedding_vector = response.data[0].embedding
print(f"向量维度: {len(embedding_vector)}")

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'your-api-key',
  baseURL: 'https://your-proxy-domain.com/v1'
});

async function getEmbedding() {
  const response = await client.embeddings.create({
    model: 'Embedding-3',
    input: '智谱AI是一家专注于大模型的公司'
  });

  const embedding = response.data[0].embedding;
  console.log(`向量维度: ${embedding.length}`);
}

getEmbedding();

cURL

curl https://your-proxy-domain.com/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "Embedding-3",
    "input": "智谱AI是一家专注于大模型的公司"
  }'