Create embeddings

curl -X POST https://api.respan.ai/api/embeddings \
     -H "Authorization: Bearer <respanApiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "model": "text-embedding-3-small",
  "input": "The quick brown fox jumps over the lazy dog"
}'

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "embedding": [
        0.0123456789,
        -0.034567891,
        0.0567891234,
        -0.0789123456,
        0.0912345678,
        -0.0112233445,
        0.0223344556,
        -0.0334455667,
        0.0445566778,
        -0.0556677889,
        0.066778899,
        -0.0778899001,
        0.0889900112,
        -0.0990011223,
        0.1001122334,
        -0.1112233445,
        0.1223344556,
        -0.1334455667,
        0.1445566778,
        -0.1556677889,
        0.166778899,
        -0.1778899001,
        0.1889900112,
        -0.1990011223,
        0.2001122334,
        -0.2112233445,
        0.2223344556,
        -0.2334455667,
        0.2445566778,
        -0.2556677889,
        0.266778899,
        -0.2778899001,
        0.2889900112,
        -0.2990011223,
        0.3001122334,
        -0.3112233445,
        0.3223344556,
        -0.3334455667,
        0.3445566778,
        -0.3556677889,
        0.366778899,
        -0.3778899001,
        0.3889900112,
        -0.3990011223,
        0.4001122334,
        -0.4112233445,
        0.4223344556,
        -0.4334455667,
        0.4445566778,
        -0.4556677889,
        0.466778899,
        -0.4778899001,
        0.4889900112,
        -0.4990011223,
        0.5001122334,
        -0.5112233445,
        0.5223344556,
        -0.5334455667,
        0.5445566778,
        -0.5556677889,
        0.566778899,
        -0.5778899001,
        0.5889900112,
        -0.5990011223,
        0.6001122334,
        -0.6112233445,
        0.6223344556,
        -0.6334455667,
        0.6445566778,
        -0.6556677889,
        0.666778899,
        -0.6778899001,
        0.6889900112,
        -0.6990011223,
        0.7001122334,
        -0.7112233445,
        0.7223344556,
        -0.7334455667,
        0.7445566778,
        -0.7556677889,
        0.766778899,
        -0.7778899001,
        0.7889900112,
        -0.7990011223,
        0.8001122334,
        -0.8112233445,
        0.8223344556,
        -0.8334455667,
        0.8445566778,
        -0.8556677889,
        0.866778899,
        -0.8778899001,
        0.8889900112,
        -0.8990011223,
        0.9001122334,
        -0.9112233445,
        0.9223344556,
        -0.9334455667,
        0.9445566778,
        -0.9556677889,
        0.966778899,
        -0.9778899001,
        0.9889900112,
        -0.9990011223,
        1.0001122334,
        -1.0112233445,
        1.0223344556,
        -1.0334455667,
        1.0445566778,
        -1.0556677889,
        1.066778899,
        -1.0778899001,
        1.0889900112,
        -1.0990011223,
        1.1001122334,
        -1.1112233445,
        1.1223344556,
        -1.1334455667,
        1.1445566778,
        -1.1556677889,
        1.166778899,
        -1.1778899001,
        1.1889900112,
        -1.1990011223,
        1.2001122334,
        -1.2112233445,
        1.2223344556,
        -1.2334455667,
        1.2445566778,
        -1.2556677889,
        1.266778899,
        -1.2778899001,
        1.2889900112,
        -1.2990011223,
        1.3001122334,
        -1.3112233445,
        1.3223344556,
        -1.3334455667,
        1.3445566778,
        -1.3556677889,
        1.366778899,
        -1.3778899001,
        1.3889900112,
        -1.3990011223,
        1.4001122334,
        -1.4112233445,
        1.4223344556,
        -1.4334455667,
        1.4445566778,
        -1.4556677889,
        1.466778899,
        -1.4778899001,
        1.4889900112,
        -1.4990011223,
        1.5001122334,
        -1.5112233445,
        1.5223344556,
        -1.5334455667,
        1.5445566778,
        -1.5556677889,
        1.566778899,
        -1.5778899001,
        1.5889900112,
        -1.5990011223,
        1.6001122334,
        -1.6112233445,
        1.6223344556,
        -1.6334455667,
        1.6445566778,
        -1.6556677889,
        1.666778899,
        -1.6778899001,
        1.6889900112,
        -1.6990011223,
        1.7001122334,
        -1.7112233445,
        1.7223344556,
        -1.7334455667,
        1.7445566778,
        -1.7556677889,
        1.766778899,
        -1.7778899001,
        1.7889900112,
        -1.7990011223,
        1.8001122334,
        -1.8112233445,
        1.8223344556,
        -1.8334455667,
        1.8445566778,
        -1.8556677889,
        1.866778899,
        -1.8778899001,
        1.8889900112,
        -1.8990011223,
        1.9001122334,
        -1.9112233445,
        1.9223344556,
        -1.9334455667,
        1.9445566778,
        -1.9556677889,
        1.966778899,
        -1.9778899001,
        1.9889900112,
        -1.9990011223,
        2.0001122334
      ],
      "index": 0
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 9,
    "total_tokens": 9
  }
}

Create embeddings through the Respan gateway with automatic logging.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Request

This endpoint expects an object.

modelenumRequired

Embedding model ID.

Allowed values:

inputanyRequired

Text to embed. String or array of strings.

encoding_formatenumOptionalDefaults to float

Output format.

Allowed values:

dimensionsintegerOptional

Output embedding dimensions. Only supported by text-embedding-3-* models.

customer_credentialsobjectOptional

Per-customer LLM provider credentials.

disable_logbooleanOptionalDefaults to false

When true, omits input/output from the log. Metrics still recorded.

metadataobjectOptional

Custom key-value metadata.

customer_identifierstringOptional

End user identifier.

thread_identifierstringOptional

Conversation thread ID.

Response

Embedding results.

objectstring

datalist of objects

modelstring

usageobject

Errors

401

Unauthorized Error

Authentication

Headers

Request

Response

Errors

Authentication

Headers

Request

Response

Errors