Repository Public
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