Skip to main content
POST
/
api
/
v2
/
embeddings
cURL
curl --request POST \
  --url https://api.deapi.ai/api/v2/embeddings \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": "This is a sample text for embedding generation.",
  "model": "Bge_M3_FP16",
  "return_result_in_response": false,
  "webhook_url": "https://your-server.com/webhooks/deapi"
}
'
{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.deapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

Generate vector embeddings from text for semantic search, clustering, and retrieval-augmented generation (RAG). Returns a request_id for status polling.
Prerequisite: Consult the Model Selection endpoint to identify a valid model slug and check its vector dimensionality and maximum input length.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept
enum<string>
default:application/json
required
Available options:
application/json

Body

application/json

Text to embedding conversion parameters

​
input
required

Input text(s) to generate embeddings for. Can be a single string or array of strings (max 2048 items). Each input limited to 8192 tokens, total request limited to 300k tokens.

Example:

"This is a sample text for embedding generation."

​
model
string
required

The embedding model to use. Available models can be retrieved via the GET /api/v1/client/models endpoint.

Example:

"Bge_M3_FP16"

​
return_result_in_response
boolean | null
default:false

If true, the embedding result will be returned directly in the response instead of only download url. Optional parameter.

Example:

false

​
webhook_url
string<uri> | null

Optional HTTPS URL to receive webhook notifications for job status changes (processing, completed, failed). Must be HTTPS. Max 2048 characters. See Webhook Documentation for payload structure and authentication details.

Maximum string length: 2048
Example:

"https://your-server.com/webhooks/deapi"

Response

ID of the inference request.

​
data
object

Information from success endpoint