Create embeddings
POST/v1/embeddings
OpenAI embeddings on an embedding alias (embed-small). Always bills to the wallet, never to the included allowance. The response's model names the model that served.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 404
- 422
- 429
- 503
The vectors, one per input.
Malformed body, or a parameter the target model cannot honor and that is refused rather than dropped (param_not_supported, invalid_param, max_tokens_exceeded, model_not_configured).
Missing or invalid Authorization: Bearer mdb_… (invalid_credentials).
The wallet is empty and this model is not covered by the included allowance (wallet_empty).
Response Headers
Machine-readable denial reason (permission_denied, rate_limited, included_allowance_exhausted, free_air_daily_spend_fuse_exceeded, wallet_empty).
Relative console URL where credit can be added.
The key is valid but not permitted here (permission_denied). When an administrator in your organization restricted the model, error.deny_detail and X-MindsHub-Deny-Detail read model_restricted: choose another model, since credit does not lift it.
Response Headers
The specific cause behind permission_denied. model_restricted when an administrator in your organization restricted the model; the body's error.deny_detail carries the same value. Absent on every other 403.
Machine-readable denial reason (permission_denied, rate_limited, included_allowance_exhausted, free_air_daily_spend_fuse_exceeded, wallet_empty).
Unknown model alias (model_not_found).
Validation Error
Too fast (rate_limited, retry after Retry-After), the included allowance is exhausted (included_allowance_exhausted), or free serving is paused until the daily budget resets (free_air_daily_spend_fuse_exceeded). The last two carry body reset_at and X-MindsHub-Reset-At, and x-should-retry: false; adding credit lifts either immediately. An organization with no included allowance gets included_allowance_exhausted with no reset_at, because nothing refills; only credit lifts it.
Response Headers
Seconds to wait before retrying.
Machine-readable denial reason (permission_denied, rate_limited, included_allowance_exhausted, free_air_daily_spend_fuse_exceeded, wallet_empty).
ISO-8601 instant the allowance refills or free serving resumes. Absent on included_allowance_exhausted when the organization has no included allowance.
false on included_allowance_exhausted and free_air_daily_spend_fuse_exceeded, so the OpenAI and Anthropic SDKs return the error on the first attempt instead of retrying it. Absent on rate_limited, which is worth retrying.
The authorization gate is unavailable (policy_unavailable). Retry.