Direct Embeddings

POST

direct

embeddings

Direct Embeddings

curl --request POST \
  --url https://platform.ai.gloo.com/ai/v2/direct/embeddings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gloo-openai-text-embedding-3-small",
  "input": [
    "In the beginning was the Word.",
    "Love is patient."
  ],
  "dimensions": 123,
  "user": "<string>"
}
'

import requests

url = "https://platform.ai.gloo.com/ai/v2/direct/embeddings"

payload = {
    "model": "gloo-openai-text-embedding-3-small",
    "input": ["In the beginning was the Word.", "Love is patient."],
    "dimensions": 123,
    "user": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'gloo-openai-text-embedding-3-small',
    input: ['In the beginning was the Word.', 'Love is patient.'],
    dimensions: 123,
    user: '<string>'
  })
};

fetch('https://platform.ai.gloo.com/ai/v2/direct/embeddings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.ai.gloo.com/ai/v2/direct/embeddings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'gloo-openai-text-embedding-3-small',
    'input' => [
        'In the beginning was the Word.',
        'Love is patient.'
    ],
    'dimensions' => 123,
    'user' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.ai.gloo.com/ai/v2/direct/embeddings"

	payload := strings.NewReader("{\n  \"model\": \"gloo-openai-text-embedding-3-small\",\n  \"input\": [\n    \"In the beginning was the Word.\",\n    \"Love is patient.\"\n  ],\n  \"dimensions\": 123,\n  \"user\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://platform.ai.gloo.com/ai/v2/direct/embeddings")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"gloo-openai-text-embedding-3-small\",\n  \"input\": [\n    \"In the beginning was the Word.\",\n    \"Love is patient.\"\n  ],\n  \"dimensions\": 123,\n  \"user\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://platform.ai.gloo.com/ai/v2/direct/embeddings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"gloo-openai-text-embedding-3-small\",\n  \"input\": [\n    \"In the beginning was the Word.\",\n    \"Love is patient.\"\n  ],\n  \"dimensions\": 123,\n  \"user\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.4155,
        0.7861,
        -0.2673,
        0.3721
      ]
    },
    {
      "object": "embedding",
      "index": 1,
      "embedding": [
        -0.0755,
        -0.301,
        -0.6606,
        0.6841
      ]
    }
  ],
  "model": "gloo-openai-text-embedding-3-small",
  "usage": {
    "prompt_tokens": 11,
    "total_tokens": 11
  }
}

{
  "detail": {
    "message": "Model 'gloo-openai-gpt-4.1-mini' is not an embedding model. /ai/v2/direct/embeddings serves the embedding models listed by /platform/v2/models.",
    "type": "invalid_request_error",
    "code": "invalid_request_error",
    "retryable": false,
    "param": "model"
  }
}

{
  "detail": "<unknown>",
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "name": "<string>",
    "category": "client_error",
    "description": "<string>",
    "fault": "client",
    "retryable": true,
    "trace_id": "<string>"
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "detail": "<unknown>",
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "name": "<string>",
    "category": "client_error",
    "description": "<string>",
    "fault": "client",
    "retryable": true,
    "trace_id": "<string>"
  }
}

{
  "detail": "<unknown>",
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "name": "<string>",
    "category": "client_error",
    "description": "<string>",
    "fault": "client",
    "retryable": true,
    "trace_id": "<string>"
  }
}

Guide: Embeddings

Model choice, input limits, pricing, and using the OpenAI SDK against this endpoint.

Error Reference

Authentication, billing, invalid model or input, unsupported dimensions, and provider errors.

Authorizations

Authorization

string

header

default:<api-key>

required

Bearer authentication header of the form Bearer <api-key>, where <api-key> is your API key.

Body

application/json

OpenAI-compatible embeddings request. Provider-specific parameters are forwarded except reserved fields. stream and provider are not forwarded; dimension, output_dimension, and output_dimensionality are rejected. user is accepted and ignored.

model

string

required

An embedding model's Gloo Model ID (e.g. gloo-openai-text-embedding-3-small). Only models whose output_modalities include embeddings on GET /platform/v2/models are accepted.

Example:

"gloo-openai-text-embedding-3-small"

input

required

The text to embed: a non-empty string, or an array of 1 to 2048 non-empty strings. Each string must fit within the model's max_input_tokens. Arrays of token IDs are not accepted.

Minimum string length: 1

Pattern: \S

Example:

[
  "In the beginning was the Word.",
  "Love is patient."
]

encoding_format

enum<string>

How each vector is encoded. float requests an array of numbers; base64 requests little-endian float32 bytes as a base64 string. When omitted, the provider's default applies. Providers may not support every encoding.

Available options:

float,

base64

dimensions

integer

Requested vector width. Support and accepted values depend on the embedding model. Unsupported models or values return 400. The public model catalog reports native dimensions but does not publish shortened-width constraints.

user

string

Accepted for OpenAI SDK compatibility and ignored.

Response

Embeddings, one per input string, in input order.

object

string

required

Allowed value: "list"

data

Embedding · object[]

required

One embedding per input string, in input order.

Show child attributes

model

string

required

The model value exactly as you sent it.

usage

object

Tokens billed for the request. Omitted if the provider reported no usage.

Show child attributes

⌘I

Direct Embeddings

curl --request POST \
  --url https://platform.ai.gloo.com/ai/v2/direct/embeddings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gloo-openai-text-embedding-3-small",
  "input": [
    "In the beginning was the Word.",
    "Love is patient."
  ],
  "dimensions": 123,
  "user": "<string>"
}
'

import requests

url = "https://platform.ai.gloo.com/ai/v2/direct/embeddings"

payload = {
    "model": "gloo-openai-text-embedding-3-small",
    "input": ["In the beginning was the Word.", "Love is patient."],
    "dimensions": 123,
    "user": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'gloo-openai-text-embedding-3-small',
    input: ['In the beginning was the Word.', 'Love is patient.'],
    dimensions: 123,
    user: '<string>'
  })
};

fetch('https://platform.ai.gloo.com/ai/v2/direct/embeddings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.ai.gloo.com/ai/v2/direct/embeddings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'gloo-openai-text-embedding-3-small',
    'input' => [
        'In the beginning was the Word.',
        'Love is patient.'
    ],
    'dimensions' => 123,
    'user' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.ai.gloo.com/ai/v2/direct/embeddings"

	payload := strings.NewReader("{\n  \"model\": \"gloo-openai-text-embedding-3-small\",\n  \"input\": [\n    \"In the beginning was the Word.\",\n    \"Love is patient.\"\n  ],\n  \"dimensions\": 123,\n  \"user\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://platform.ai.gloo.com/ai/v2/direct/embeddings")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"gloo-openai-text-embedding-3-small\",\n  \"input\": [\n    \"In the beginning was the Word.\",\n    \"Love is patient.\"\n  ],\n  \"dimensions\": 123,\n  \"user\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://platform.ai.gloo.com/ai/v2/direct/embeddings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"gloo-openai-text-embedding-3-small\",\n  \"input\": [\n    \"In the beginning was the Word.\",\n    \"Love is patient.\"\n  ],\n  \"dimensions\": 123,\n  \"user\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.4155,
        0.7861,
        -0.2673,
        0.3721
      ]
    },
    {
      "object": "embedding",
      "index": 1,
      "embedding": [
        -0.0755,
        -0.301,
        -0.6606,
        0.6841
      ]
    }
  ],
  "model": "gloo-openai-text-embedding-3-small",
  "usage": {
    "prompt_tokens": 11,
    "total_tokens": 11
  }
}

{
  "detail": {
    "message": "Model 'gloo-openai-gpt-4.1-mini' is not an embedding model. /ai/v2/direct/embeddings serves the embedding models listed by /platform/v2/models.",
    "type": "invalid_request_error",
    "code": "invalid_request_error",
    "retryable": false,
    "param": "model"
  }
}

{
  "detail": "<unknown>",
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "name": "<string>",
    "category": "client_error",
    "description": "<string>",
    "fault": "client",
    "retryable": true,
    "trace_id": "<string>"
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "detail": "<unknown>",
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "name": "<string>",
    "category": "client_error",
    "description": "<string>",
    "fault": "client",
    "retryable": true,
    "trace_id": "<string>"
  }
}

{
  "detail": "<unknown>",
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "name": "<string>",
    "category": "client_error",
    "description": "<string>",
    "fault": "client",
    "retryable": true,
    "trace_id": "<string>"
  }
}

General

Models

Responses & Completions

Embeddings

Content

Data Engine Content Controls

Legacy / Deprecated APIs

Direct Embeddings

Guide: Embeddings

Error Reference

Authorizations

Body

Response