SPB Git

Repository Public

gemini-lifecycles.json 5.8 KB 218 lines json

1[2 {3  "provider": "gemini",4  "object": "GenerateContentBatch / EmbedContentBatch",5  "api_family": "batch",6  "status_field": "metadata.state (Operation) / state (batch resource)",7  "states": {8   "BATCH_STATE_PENDING": "Created, waiting to be scheduled (initial state returned by create).",9   "BATCH_STATE_RUNNING": "Requests executing; batchStats.pendingRequestCount decreases.",10   "BATCH_STATE_SUCCEEDED": "Terminal. done=true, response.inlinedResponses or response.responsesFile available (results kept 6 weeks).",11   "BATCH_STATE_FAILED": "Terminal. done=true with error (Status).",12   "BATCH_STATE_CANCELLED": "Terminal after :cancel; Operation.error.code = 1 (CANCELLED).",13   "BATCH_STATE_EXPIRED": "Terminal. Pending/running for more than 48 h; no results; resubmit smaller batches.",14   "BATCH_STATE_UNSPECIFIED": "Default/unknown."15  },16  "initial": "BATCH_STATE_PENDING",17  "terminal": [18   "BATCH_STATE_SUCCEEDED",19   "BATCH_STATE_FAILED",20   "BATCH_STATE_CANCELLED",21   "BATCH_STATE_EXPIRED"22  ],23  "transitions": [24   [25    "BATCH_STATE_PENDING",26    "BATCH_STATE_RUNNING"27   ],28   [29    "BATCH_STATE_RUNNING",30    "BATCH_STATE_SUCCEEDED"31   ],32   [33    "BATCH_STATE_RUNNING",34    "BATCH_STATE_FAILED"35   ],36   [37    "BATCH_STATE_PENDING",38    "BATCH_STATE_CANCELLED"39   ],40   [41    "BATCH_STATE_RUNNING",42    "BATCH_STATE_CANCELLED"43   ],44   [45    "BATCH_STATE_PENDING",46    "BATCH_STATE_EXPIRED"47   ],48   [49    "BATCH_STATE_RUNNING",50    "BATCH_STATE_EXPIRED"51   ]52  ],53  "timestamps": [54   "createTime",55   "updateTime",56   "endTime"57  ],58  "observed": {59   "2026-09-18": "no batch could be created with this key: every batchGenerateContent / asyncBatchEmbedContent body -> HTTP 400 FAILED_PRECONDITION: Precondition check failed. (Batch API has no free tier); GET /v1beta/batches -> 200 {}"60  },61  "status": [62   "DOCUMENTED",63   "ACCOUNT_RESTRICTED"64  ],65  "notes": "The guide's prose uses JOB_STATE_* names (SDK JobState enum: QUEUED, PENDING, RUNNING, SUCCEEDED, FAILED, CANCELLING, CANCELLED, PAUSED, EXPIRED, UPDATING, PARTIALLY_SUCCEEDED) while the REST enum is BATCH_STATE_*. Live create returned state None. Target turnaround 24 h; expiry 48 h; 50% price.",66  "sources": [67   {68    "url": "https://ai.google.dev/gemini-api/docs/batch-api",69    "retrieved_at": "2026-09-18"70   },71   {72    "url": "https://ai.google.dev/api/batch-api",73    "retrieved_at": "2026-09-18"74   },75   {76    "url": "https://github.com/googleapis/python-genai/blob/main/google/genai/types.py",77    "retrieved_at": "2026-09-18"78   }79  ]80 },81 {82  "provider": "gemini",83  "object": "Operation (predictLongRunning / Veo)",84  "api_family": "video-generation",85  "status_field": "done (+ error|response)",86  "states": {87   "done=false": "Generation running (11 s to 6 min). metadata may be absent. Poll GET /v1beta/{name} every ~10 s or subscribe to webhooks.",88   "done=true + response": "Success: response.generateVideoResponse.generatedSamples[].video.uri (download within 2 days).",89   "done=true + error": "Failure (safety/audio filters, invalid input). Not billed when the video is blocked."90  },91  "initial": "done=false",92  "terminal": [93   "done=true + response",94   "done=true + error"95  ],96  "transitions": [97   [98    "done=false",99    "done=true + response"100   ],101   [102    "done=false",103    "done=true + error"104   ]105  ],106  "timestamps": [],107  "observed": {108   "2026-09-18": "validation probes only: {} -> HTTP 400, instances:[{}] -> HTTP 400, bogus operation GET -> HTTP 403"109  },110  "status": [111   "DOCUMENTED"112  ],113  "notes": "No cancel method for model operations in the discovery document (only batches have :cancel). Generated video files also appear as generatedFiles (state GENERATING -> GENERATED | FAILED).",114  "sources": [115   {116    "url": "https://ai.google.dev/gemini-api/docs/veo",117    "retrieved_at": "2026-09-18"118   },119   {120    "url": "https://generativelanguage.googleapis.com/$discovery/rest?version=v1beta",121    "retrieved_at": "2026-09-18"122   }123  ]124 },125 {126  "provider": "gemini",127  "object": "GeneratedFile",128  "api_family": "files",129  "status_field": "state",130  "states": {131   "GENERATING": "Model is producing the file.",132   "GENERATED": "Ready to download.",133   "FAILED": "error (Status) set.",134   "STATE_UNSPECIFIED": "Default."135  },136  "initial": "GENERATING",137  "terminal": [138   "GENERATED",139   "FAILED"140  ],141  "transitions": [142   [143    "GENERATING",144    "GENERATED"145   ],146   [147    "GENERATING",148    "FAILED"149   ]150  ],151  "timestamps": [],152  "observed": {153   "2026-09-18": "GET /v1beta/generatedFiles -> HTTP 200 {}"154  },155  "status": [156   "DOCUMENTED",157   "LIVE_VERIFIED"158  ],159  "sources": [160   {161    "url": "https://generativelanguage.googleapis.com/$discovery/rest?version=v1beta",162    "retrieved_at": "2026-09-18"163   }164  ]165 },166 {167  "provider": "gemini",168  "object": "TunedModel",169  "api_family": "tuning",170  "status_field": "state",171  "states": {172   "CREATING": "Tuning in progress (track via tunedModels/{id}/operations/{op}: completedSteps/totalSteps, snapshots).",173   "ACTIVE": "Ready for generateContent.",174   "FAILED": "Tuning failed.",175   "STATE_UNSPECIFIED": "Unused default."176  },177  "initial": "CREATING",178  "terminal": [179   "ACTIVE",180   "FAILED"181  ],182  "transitions": [183   [184    "CREATING",185    "ACTIVE"186   ],187   [188    "CREATING",189    "FAILED"190   ]191  ],192  "timestamps": [193   "createTime",194   "updateTime",195   "tuningTask.startTime",196   "tuningTask.completeTime"197  ],198  "observed": {199   "2026-09-18": "GET /v1beta/tunedModels -> HTTP 501 {\"error\": {\"code\": 501, \"message\": \"Operation is not implemented, or supported, ; no tuned model created (fine-tuning unavailable in the Gemini API since May 2025)"200  },201  "status": [202   "DOCUMENTED",203   "LEGACY",204   "DEPRECATED"205  ],206  "sources": [207   {208    "url": "https://ai.google.dev/api/tuning",209    "retrieved_at": "2026-09-18"210   },211   {212    "url": "https://ai.google.dev/gemini-api/docs/model-tuning",213    "retrieved_at": "2026-09-18"214   }215  ]216 }217]218
Files main
Menu

Theme