- Input / 1M tokens
- $0
- Example workload
- $0 · 1M embedded tokens
Call it from any OpenAI SDK
Use the official SDK with a custom base URL. The example below is complete — swap the model id to hit a different model in the catalog.
curl https://api.apiraven.com/v1/embeddings \
-H "Authorization: Bearer $APIRAVEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "baai/bge-m3-multi-8k",
"input": ["first document", "second document"],
"encoding_format": "float"
}'Standardized parameters
Parameters behave the same on every backend. Values that cannot be honored are either mapped to the closest equivalent or safely dropped — never silently corrupted.
| Parameter | Type | Default | Range | Status |
|---|---|---|---|---|
| Core | ||||
inputUp to 2,048 texts per request. | string | string[] | — | — | Supported |
dimensionsMatryoshka truncation where supported. | integer | model default | — | Supported |
| Output | ||||
encoding_format | enum | float | float | base64 | Supported |
Using bge-m3-multi-8k on APIRaven
Which provider actually runs my request?+
APIRaven routes each request across a pool of managed inference backends. The model id, request shape and response are identical no matter which backend serves it — you never manage provider accounts, keys or regions.
Is the API OpenAI-compatible?+
Yes. Point any OpenAI SDK at https://api.apiraven.com/v1 with your APIRaven key. Chat, vision, images, embeddings and audio all follow the OpenAI request and response shapes.
What happens when a backend degrades?+
Requests are retried and failed over automatically before the first token is returned. If a model is temporarily unavailable, the API returns one stable error envelope instead of a provider-specific failure.
How is usage billed?+
Per token for text, per image for generation and per minute for transcription — deducted from your APIRaven balance. Every response includes normalized usage so you can meter cost per request.
Ship with baai/bge-m3-multi-8k
One base URL, one balance, every model. Point your OpenAI SDK at APIRaven and switch models with a single string.