models

Gemini Embedding 001 Batch

Markdown · JSON

Gemini Embedding 001 Batch

google/gemini-embedding-001:batch
GoogleEmbeddingsAuto · Ultra

Converts text into vectors in asynchronous batch jobs.

Ultra BatchPOST /v1/batches
Input types
text
Output types
embedding
Context
Not specified in the catalogue
Max. output
Not specified in the catalogue
Input
$0.00015 / 1K
Output
$0.00 / 1K
Method parameters and lifecycle
ParameterContract
ParameterendpointContract/v1/embeddings
ParametermodelContractgoogle/gemini-embedding-001:batch
ParameterrequestsContractcustom_id + body.input

Lifecycle: asynchronous

GET /v1/batches/{request_id} · response.id

Submit the batch once. Keep its returned id and read that job with the same API key. Completed jobs return the vectors inline.

Submit the batch once. Keep its returned id and read that job with the same API key. Completed jobs return the vectors inline.

POST /v1/batches

curl --silent --show-error https://api.ailoot.ai/v1/batches \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Ailoot-Routing-Mode: ultra" \
  --data '{"model":"google/gemini-embedding-001:batch","endpoint":"/v1/embeddings","requests":[{"custom_id":"text-1","body":{"input":"First document"}}]}'

GET /v1/batches/{request_id}

curl --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_ID" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "X-Ailoot-Routing-Mode: ultra"
JSON
{"about":"Converts text into vectors in asynchronous batch jobs. Submit the batch once. Keep its returned id and read that job with the same API key. Completed jobs return the vectors inline.","alias_of":null,"aliases":[],"author":"Google","available":true,"canonical_model":"google/gemini-embedding-001:batch","card_routes":[{"label":"Ultra","rates":[{"amount":0.15,"amount_unit":"usd_per_million_tokens","key":"in","label":"Input","side":"in"}]}],"ctx":null,"formats":["batches"],"id":"google/gemini-embedding-001:batch","input":["text"],"kind":"embedding","max_out":null,"methods":[{"contract":{"data":{"example_body":{"endpoint":"/v1/embeddings","model":"google/gemini-embedding-001:batch","requests":[{"body":{"input":"First document"},"custom_id":"text-1"}]},"outputs":{"family":"embedding","fields":[{"name":"id","type":"string"},{"name":"status","type":"string"},{"name":"results[].custom_id","type":"string"},{"name":"results[].response.body.data[].embedding","type":"number[]"},{"name":"results[].error","type":"object|null"}],"format":"JSON","vector_dimensions":3072},"parameters":[{"enum":["google/gemini-embedding-001:batch"],"name":"model","required":true,"type":"string"},{"enum":["/v1/embeddings"],"name":"endpoint","required":true,"type":"string"},{"min_items":1,"name":"requests","required":true,"type":"batch_item[]"},{"name":"requests[].custom_id","required":true,"type":"string","unique_within_batch":true},{"name":"requests[].body.input","required":true,"type":"string"}]},"hints":["Submit the batch once. Keep its returned id and read that job with the same API key. Completed jobs return the vectors inline."],"input":{"endpoint":"/v1/embeddings","model":"google/gemini-embedding-001:batch","requests":"custom_id + body.input"},"lifecycle":{"create":{"accepted_status":202,"http":"POST","path":"/v1/batches"},"mode":"asynchronous","status":{"http":"GET","id_source":"response.id","path":"/v1/batches/{request_id}"}},"method":{"http":"POST","path":"/v1/batches"},"output":{"family":"embedding","fields":[{"name":"id","type":"string"},{"name":"status","type":"string"},{"name":"results[].custom_id","type":"string"},{"name":"results[].response.body.data[].embedding","type":"number[]"},{"name":"results[].error","type":"object|null"}],"format":"JSON","vector_dimensions":3072}},"ctx":null,"examples":[{"code":"curl --silent --show-error https://api.ailoot.ai/v1/batches \\\n  -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-Ailoot-Routing-Mode: ultra\" \\\n  --data '{\"model\":\"google/gemini-embedding-001:batch\",\"endpoint\":\"/v1/embeddings\",\"requests\":[{\"custom_id\":\"text-1\",\"body\":{\"input\":\"First document\"}}]}'","label":"curl · POST /v1/batches","language":"bash"},{"code":"curl --silent --show-error \"https://api.ailoot.ai/v1/batches/$BATCH_ID\" \\\n  -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n  -H \"X-Ailoot-Routing-Mode: ultra\"","label":"curl · GET /v1/batches/{request_id}","language":"bash"}],"family":"batch","fmt":"batches","hints":["Submit the batch once. Keep its returned id and read that job with the same API key. Completed jobs return the vectors inline."],"http":"POST","img_in":null,"img_out":null,"in":0.15,"input":["text"],"label":"Batch","max_out":null,"native_endpoint":"batches","out":0,"output":["embedding"],"path":"/v1/batches","pricing":{"billing_mode":"token","cache_write_1h_usd_per_token":null,"cache_write_5m_usd_per_token":null,"currency":"USD","input_usd_per_token":1.5e-07,"output_usd_per_token":0,"price_policy":"native_accepted_retail_card","provenance":"native_group_model_pricing","status":"configured","tiers":[{"cache_write_1h_usd_per_token":null,"cache_write_5m_usd_per_token":null,"input_usd_per_token":1.5e-07,"interval_boundary":"min_exclusive_max_inclusive","label":"","min_tokens":0,"null_rate_policy":"inherit_base_rate","output_usd_per_token":0}]},"request_model_id":"google/gemini-embedding-001:batch","route_label":"Ultra","route_tier":"ultra","status_reads":["GET /v1/batches/{request_id}"],"tiers":[],"unit":"token","units":[]}],"model_aliases":[],"name":"Gemini Embedding 001 Batch","price":{"in":0.15,"in_label":null,"out":0,"out_label":null,"sort_in":0.15,"sort_out":0,"varies":false},"public_id":"google/gemini-embedding-001:batch","short":"Converts text into vectors in asynchronous batch jobs."}

Questions

How do I choose a model for my task?

First identify the required input and output: text, image, audio or video. Then compare compatible API methods, the exact model ID or current alias target, price and billing unit. GET /v1/models is free and lists models available to your key.

Does each model support every API method and media type?

Use the API methods and input/output types listed on the model card. Support for text, images, audio or video depends on the selected model and method; check their request example before sending your data.

What is the difference between a model ID and an alias?

An exact model ID names a specific model. An alias points to a model and its target can change. Check the current alias target in the catalogue; use the exact ID when your integration needs a specific model.

How do I compare prices before sending a request?

Check the model card for the price and billing unit of the selected API method. Compare the same unit and input/output type; request history shows actual usage and the charged amount.

What does a subscription give me?

A discount on token purchases for regular use. Choose a plan for your request volume; subscription terms and pricing are shown at checkout.

How do I apply a promo code for up to 50% off?

Enter the promo code when buying tokens. The total updates according to the promotion terms; you can see the discount before paying.