Create embeddings
const url = 'https://api.katara.com/v1/embeddings';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"model":"katara/bge-base-en-v1.5@1","input":["The first passage.","The second passage."]}'};
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://api.katara.com/v1/embeddings \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "katara/bge-base-en-v1.5@1", "input": [ "The first passage.", "The second passage." ] }'The OpenAI embeddings request. One vector per input, from katara/bge-base-en-v1.5@1
(768 dimensions, up to 100 inputs of up to 512 tokens each). A key pays with Account
Credits or USDC; without a key the call is paid with x402 like a chat completion: the
quote assumes every input is as long as the model takes, the settlement charges the tokens
counted, at least 0.025 USDC. Embeddings never reach Katara Community.
Embeddings describes the fields.
Authorizations
Section titled “Authorizations”- bearerAuth
- None
Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”Without a key, base64 of the x402 payment payload that signs the quote from a previous 402.
The same payload under the header name of the first x402 version, paid with exact.
Request Bodyrequired
Section titled “Request Bodyrequired”object
Only the model’s own size.
Accepted and not passed on.
Example
{ "model": "katara/bge-base-en-v1.5@1", "input": [ "The first passage.", "The second passage." ]}Responses
Section titled “Responses”The vectors.
object
object
object
The tokens charged for.
What this reply cost and who produced it.
object
The settled price, in USDC, as a decimal string. For a request paid with x402 it is the charge, the 0.025 USDC minimum included.
The Credits charge as a decimal string. This legacy field name is retained for compatibility; display Credits without a dollar sign.
On a request paid with x402, the payment that settles the reply.
object
The token paid.
The charge in the token’s base units, the same as amount in PAYMENT-RESPONSE.
The provider’s address, or managed when a vendor answered.
The concrete model behind every successful named-model or Cortex reply.
object
The address that served, or the managed identity.
True when a managed vendor answered.
named for a selected model, available, pinned, failover:<n> after n models failed before delivering, or managed:<why>.
What this reply cost and who produced it.
object
The settled price, in USDC, as a decimal string. For a request paid with x402 it is the charge, the 0.025 USDC minimum included.
The Credits charge as a decimal string. This legacy field name is retained for compatibility; display Credits without a dollar sign.
On a request paid with x402, the payment that settles the reply.
object
The token paid.
The charge in the token’s base units, the same as amount in PAYMENT-RESPONSE.
The provider’s address, or managed when a vendor answered.
The concrete model behind every successful named-model or Cortex reply.
object
The address that served, or the managed identity.
True when a managed vendor answered.
named for a selected model, available, pinned, failover:<n> after n models failed before delivering, or managed:<why>.
Example
{ "object": "list", "data": [ { "object": "embedding" } ], "katara": { "cost_usdc": "0.000018", "cost_usd": "0.000018", "billing_method": "credits", "payment": { "scheme": "upto", "network": "eip155:43114", "amount": "25000" }, "served": { "model": "katara/qwen3-coder-30b-a3b@1" } }}Headers
Section titled “Headers”On a call paid with x402, as for chat completions; amount is the charge.
A field the route does not take (unsupported_parameter, with param), a malformed request (invalid_request), a model that does not produce embeddings (feature_not_supported), or a credits key and a model its credits cannot pay for (model_requires_usdc).
object
object
For people. Wording may change.
Stable. Branch on this.
Example
{ "error": { "type": "invalid_request_error", "code": "invalid_api_key" }}Unknown key, or a call to the Test network without one (invalid_api_key).
object
object
For people. Wording may change.
Stable. Branch on this.
Example
{ "error": { "type": "invalid_request_error", "code": "invalid_api_key" }}Without a key, a quote (with PAYMENT-REQUIRED) or a payment that does not verify (payment_invalid); with a credits key, insufficient_credits.
object
object
For people. Wording may change.
Stable. Branch on this.
An x402 quote for one request.
object
The ways this request can be paid, for the same maximum. upto entries, where offered, come before exact. Sign one.
object
upto: a Permit2 transfer of at most amount, of which only the charge is pulled. exact: an EIP-3009 transfer of amount, with the difference refunded. Neither collects more than was signed.
The chain as a CAIP-2 id.
The USDC contract the authorization is for.
The most this request can cost, in the token’s base units. At least 25000 (0.025 USDC).
The settlement contract; the authorization’s to.
Validity to give the authorization.
object
The token’s EIP-712 domain name.
The token’s EIP-712 domain version.
exact only. The job this quote is bound to. It may be signed as the authorization nonce; a random nonce also works.
The job this quote is bound to.
upto only.
upto only. The address that settles; the signed witness names it.
The address paid for the reply.
The model the request named.
The model that will answer.
True when a vendor’s model will answer.
eip2612GasSponsoring, when present: the token takes EIP-2612 permits, and a permit for
Permit2 sent with an upto payment is submitted with the settlement at Katara’s cost.
object
Example
{ "error": { "type": "invalid_request_error", "code": "invalid_api_key" }}Headers
Section titled “Headers”Base64 of the PaymentRequired object in the body. Present only on a quote.
Unknown model (model_not_found).
object
object
For people. Wording may change.
Stable. Branch on this.
Example
{ "error": { "type": "invalid_request_error", "code": "invalid_api_key" }}An upto payment from a wallet that has not approved Permit2 and carries no permit (permit2_allowance_required).
object
object
For people. Wording may change.
Stable. Branch on this.
Example
{ "error": { "type": "invalid_request_error", "code": "invalid_api_key" }}A USDC key whose balance cannot cover the call (insufficient_quota), or too many unpaid quotes from one address (quote_rate_limited).
object
object
For people. Wording may change.
Stable. Branch on this.
Example
{ "error": { "type": "invalid_request_error", "code": "invalid_api_key" }}Headers
Section titled “Headers”The embeddings provider failed (provider_failed) or refused the request (provider_rejected_request). Nothing was charged.
object
object
For people. Wording may change.
Stable. Branch on this.
Example
{ "error": { "type": "invalid_request_error", "code": "invalid_api_key" }}The model cannot be served right now (no_capacity). Retry after Retry-After.
object
object
For people. Wording may change.
Stable. Branch on this.
Example
{ "error": { "type": "invalid_request_error", "code": "invalid_api_key" }}