embeddinggemma-2 API

What is embeddinggemma-2?

Use the public identifier di-googleembeddinggemma-2-39b44716f6 for embeddinggemma-2 in ServerNet. The gateway uses this identifier to select the configured route; the developer is google.

For embeddinggemma-2, test the exact model size on your own task. A family’s multimodal capability does not make media inputs available on a text-only gateway route.

Where to use embeddinggemma-2

• Index document chunks with embeddinggemma-2 for semantic search.
• Embed the search query with the same embeddinggemma-2 model used to build your index.
• Evaluate retrieval quality before combining the results with a text-generation model.

Build your integration

Send a string or a list of strings to /v1/embeddings. Store the returned vectors in your search index. When switching models, rebuild the index and check vector dimensions instead of mixing incompatible vectors.

Inputs and service limits

The route accepts plain text and batches of up to 128 texts. Token ID arrays, media inputs and unsupported output formats are refused. Choose chunk sizes within the model’s configured input limit.

A request cost example

For 1,000 input tokens and 0 output tokens, without a cache discount. This is a catalogue estimate, not a fixed request fee. Reported consumption and the price frozen for your request determine the usage amount.

Estimated usage, Toman

7

Connect to embeddinggemma-2 API

Enable ai:embedding on your key and ai:models:read to check availability. Set SERVERNET_API_KEY in your server environment. Change the idempotency key for each new request; keep it unchanged only for an identical retry.

curl https://servernet.cloud/v1/embeddings \
  -H "Authorization: Bearer $SERVERNET_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: CHANGE_FOR_EACH_NEW_REQUEST' \
  -d '{
    "model": "di-googleembeddinggemma-2-39b44716f6",
    "input": [
        "Hello world",
        "Search documents"
    ]
}'

Use the same Idempotency-Key when retrying an identical request. Successful responses are replayed without a second charge for 24 hours. Do not automatically retry when x-should-retry:false is present. The key is shown once. Store it in a server environment variable. Keep it out of browser code, GitHub and logs.

Compare models for the same task