embeddings
POST
/v1/embeddings
const url = 'https://example.com/v1/embeddings';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"dimensions":null,"encoding_format":"float","input":["example"],"model":"default","truncate_sequence":null,"user":null}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/v1/embeddings \ --header 'Content-Type: application/json' \ --data '{ "dimensions": null, "encoding_format": "float", "input": [ "example" ], "model": "default", "truncate_sequence": null, "user": null }'Request Body required
Section titled “Request Body required ” Media type application/json
object
dimensions
Truncate embeddings to this dimensionality, if the model supports it.
integer | null
Example
null encoding_format
input
required
One of:
Single input string
string
Multiple input strings
Array<string>
Single token array
Array<integer>
Multiple token arrays
Array<Array<integer>>
model
Model ID; “default” targets the only loaded model.
string
Example
default truncate_sequence
Truncate inputs that exceed the model’s context length instead of erroring.
boolean | null
Example
null user
string | null
Example
nullResponses
Section titled “ Responses ”Embeddings
Media type application/json
object
data
required
Array<object>
object
embedding
required
One of:
Embedding returned as an array of floats
Array<number>
Embedding returned as a base64-encoded string
string
index
required
integer
object
required
string
model
required
string
object
required
string
usage
required
object
prompt_tokens
required
integer format: int32
total_tokens
required
integer format: int32
Example generated
{ "data": [ { "embedding": [ 1 ], "index": 1, "object": "example" } ], "model": "example", "object": "example", "usage": { "prompt_tokens": 1, "total_tokens": 1 }}