Google: Gemini Embedding 2 (batch)
Το Gemini Embedding 2 Batch υποβάλλει ομάδες αιτημάτων κειμενικών διανυσματικών αναπαραστάσεων ως μία παρτίδα Ailoot. Παρακολουθήστε κάθε στοιχείο μέσω custom_id και ανακτήστε τα πλήρη αποτελέσματα της αρχικής λειτουργίας.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Gemini Embedding 2 Batch χρησιμοποιεί το /v1/batches με το ακριβές αναγνωριστικό google/gemini-embedding-2:batch. Ορίστε endpoint σε /v1/embeddings και δώστε requests· κάθε στοιχείο περιέχει custom_id και body με input ως συμβολοσειρά κειμένου ή πίνακα συμβολοσειρών. Κρατήστε σταθερά τα αναγνωριστικά ώστε η εφαρμογή να αντιστοιχίζει τα αποτελέσματα σε προετοιμασμένη συλλογή εγγράφων.
Η παρτίδα είναι ασύγχρονη. Κρατήστε το αρχικό αναγνωριστικό λειτουργίας και χρησιμοποιήστε GET /v1/batches/{operation_id} για να παρακολουθείτε την ίδια λειτουργία με τον ίδιο καλούντα. Ένα ολοκληρωμένο σύνολο αποτελεσμάτων μπορεί να περιέχει απόκριση ή σφάλμα για κάθε custom_id· εξετάστε λοιπόν τόσο τα αποτελέσματα των στοιχείων όσο και τη συνολική κατάσταση.
Αποθηκεύστε όλα τα ολοκληρωμένα αποτελέσματα ως JSONL, διατηρώντας κάθε custom_id και την πλήρη απόκριση ή το σφάλμα του. Αντιστοιχίστε τα επιτυχημένα διανύσματα στα υποβληθέντα αναγνωριστικά εγγράφων πριν ενημερώσετε το ευρετήριο. Κρατήστε μαζί τις εγγραφές αρχικής λειτουργίας και στοιχείων, ώστε να διερευνάται ένα ημιτελές ή αποτυχημένο στοιχείο χωρίς να χάνονται τα ήδη επιστρεφόμενα αποτελέσματα.
Ailoot Ultra · Batch POST /v1/batches google/gemini-embedding-2:batch
google/gemini-embedding-2:batch
google/gemini-embedding-2:batchΕισαγωγή
Το Gemini Embedding 2 Batch υποβάλλει ομάδες αιτημάτων κειμενικών διανυσματικών αναπαραστάσεων ως μία παρτίδα Ailoot. Παρακολουθήστε κάθε στοιχείο μέσω custom_id και ανακτήστε τα πλήρη αποτελέσματα της αρχικής λειτουργίας.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- embedding
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Batch POST /v1/batches
- Είσοδος
text- Έξοδος
embedding
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια google/gemini-embedding-2:batch Συνθήκες: Χρησιμοποιήστε ακριβώς αυτόν τον επιλογέα δρομολόγησης του Ailoot. | Προεπιλογή— |
Πεδίοendpoint | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια /v1/embeddings Συνθήκες: | Προεπιλογή— |
Πεδίοrequests | Τύποςarray | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, endpoint, requests |
Παράμετροςoptional | Σύμβαση |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςconditions | ΣύμβασηΧρησιμοποιήστε ακριβώς αυτόν τον επιλογέα δρομολόγησης του Ailoot. |
Κύκλος ζωής: asynchronous
GET /v1/batches/{operation_id} · Το πραγματικό αρχικό response.id, με τον ίδιο καλούντα, κλειδί και ομάδα.
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
- Τιμολόγηση ρητής αποθήκευσης στην κρυφή μνήμη
- Δεν είναι ενεργοποιημένο Όταν ζητείται ρητή αποθήκευση στην κρυφή μνήμη
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Token συμφραζομένων, πάνω από | Token συμφραζομένων, έως και | Χρέωση |
|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Token συμφραζομένων, πάνω από— | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.0002 / 1K token Έξοδος · Token εξόδου $0 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| ΔιαμόρφωσηΕπίπεδο 1 βάσει μήκους αιτήματος | Πίνακας χρεώσεων— | Token συμφραζομένων, πάνω από0 | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.0002 / 1K token Έξοδος · Token εξόδου $0 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Batch
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"endpoint": "/v1/embeddings", "model": "google/gemini-embedding-2:batch", "requests": [{"custom_id": "embedding-1", "body": {"input": "The quick brown fox jumps over the lazy dog"}}]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_BATCH'
import json,os,subprocess
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path("result.json").read_text()); operation=r["id"]
subprocess.run(["curl","--fail-with-body","--silent","--show-error","https://api.ailoot.ai/v1/batches/"+quote(operation,safe=""),"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
s=json.loads(Path("status.json").read_text())
if s.get("status")=="completed": Path("results.jsonl").write_text("".join(json.dumps(x,ensure_ascii=False)+"\n" for x in s.get("results",[])))
# Repeat only this same original GET while pending; never repeat creation.
PY_BATCH
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε την αρχική κατάσταση, κάθε custom_id και την πλήρη απόκριση ή το σφάλμα. Αποθηκεύστε όλα τα ολοκληρωμένα results[] ως JSONL· δεν συνάγεται διαδρομή μεταφόρτωσης ή λήψης μέσω Files.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε το αρχικό αναγνωριστικό λειτουργίας και διαβάστε μόνο εκείνη την αρχική παρτίδα. Η λήξη χρονικού ορίου, ένα σφάλμα ή μια άγνωστη κατάσταση δεν επιτρέπουν νέο αίτημα δημιουργίας.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοresults[] | Τύποςarray |
Πεδίοresults[].custom_id | Τύποςstring |
Πεδίοresults[].response | Τύποςobject |
Πεδίοresults[].error | Τύποςobject |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΈνα υποχρεωτικό πεδίο, ο επιλογέας μοντέλου, ο τύπος ή η μορφή αναπαράστασης της εισόδου δεν είναι έγκυρα. | Επόμενο βήμαΕξετάστε τις λεπτομέρειες επικύρωσης που επιστράφηκαν πριν ετοιμάσετε ξεχωριστό αίτημα. |
Απάντηση | ΣυνθήκηΤο αρχικό αίτημα ή αποτέλεσμα είναι άγνωστο ή απαιτεί έλεγχο. | Επόμενο βήμαΔιατηρήστε τα αρχικά αναγνωριστικά και τις κεφαλίδες· διαβάστε μόνο τις υποστηριζόμενες εγγραφές κατάστασης ή βιβλιοθήκης. Μην υποβάλετε ξανά αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra google/gemini-embedding-2:batch
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · Google: Gemini Embedding 2 (batch)
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/batches·google/gemini-embedding-2:batch:text→embedding- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/batches·google/gemini-embedding-2:batch:model,endpoint,requests