API 레퍼런스

임베딩

아직 지원하는 모델이 없습니다

현재 모델 목록에서 이 경로를 지원하는 모델이 없습니다. 이 페이지는 참고용으로 남겨 둡니다.
POST/v1/embeddings

OpenAI 형식의 벡터 임베딩 — text-embedding-3, jina-embeddings, voyage 및 각 제공업체의 동급 모델. 입력 토큰 기준으로 과금됩니다.

#요청 파라미터

  • modelstring필수

    임베딩 모델 ID(예: text-embedding-3-small).

  • inputstring | array필수

    문자열 하나 또는 배열 — 응답은 같은 순서로 벡터를 반환합니다.

  • dimensionsinteger선택

    Matryoshka 차원을 지원하는 모델에서 벡터를 잘라냅니다.

  • encoding_formatstring선택

    "float"(기본값) 또는 더 작은 페이로드를 위한 "base64".

#관련 오류

  • 400 invalid_request_error본문 형식이 잘못되었거나 이 모델이 지원하지 않는 파라미터입니다.
  • 401Bearer 토큰이 유효하지 않거나 없습니다. 이 경로에는 error.code가 없으므로 상태 코드로 판단하세요.
  • 402 insufficient_user_quota지갑 잔액이 사전 차감 추정액보다 부족합니다.
  • 429키별 속도 제한입니다. 본문은 비어 있으며 Retry-After만큼 기다리세요. insufficient_user_quota가 포함된 429는 속도 제한이 아니라 일일 지출 한도입니다.
  • 503 model_not_found알 수 없는 모델이거나, 현재 이 모델을 제공하는 정상 채널이 없습니다.

전체 오류 코드 표 →

#요청 예시

curl https://www.aisplice.store/v1/embeddings \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": ["hello world", "another sentence"]
  }'

#응답

response.json
{
  "object": "list",
  "model": "text-embedding-3-small",
  "data": [
    {"object": "embedding", "index": 0, "embedding": [0.0023, -0.0091, …]},
    {"object": "embedding", "index": 1, "embedding": [0.0154,  0.0007, …]}
  ],
  "usage": {"prompt_tokens": 8, "total_tokens": 8}
}

아직 해결되지 않았나요?

요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.