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": [
    {
      "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>"
  }
}

Guide: Embeddings

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

Error Reference

Common errors: not an embedding model, invalid input, input longer than the model’s limit, provider unavailable.

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. Parameters not listed here are forwarded to the model provider unchanged.

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 returns an array of numbers; base64 returns the little-endian float32 bytes as a base64 string. When omitted, the provider's default applies (an array of floats).

Available options:

float,

base64

dimensions

integer

Number of dimensions to return, for models that support shortened embeddings (such as the OpenAI text-embedding-3 models). Omit it for other models.

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": [
    {
      "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>"
  }
}

General

Models

Responses & Completions

Embeddings

Content

Data Engine Content Controls

Legacy / Deprecated APIs

Direct Embeddings

Guide: Embeddings

Error Reference

Authorizations

Body

Response