SPB Git

Repository Public

openai-lifecycles.json 10.8 KB 179 lines json

1[2 {3  "provider": "openai",4  "object": "batch",5  "api_family": "batches",6  "status_field": "status",7  "states": {8   "validating": "Input file is being validated (format, model, file access). request_counts.total is 0 until validation passes.",9   "failed": "Terminal. Input validation failed; `errors.data[]` lists {code, message, param, line}. No output file.",10   "in_progress": "Requests are executing. request_counts.completed/failed increase.",11   "finalizing": "All requests done; output/error files are being written.",12   "completed": "Terminal. output_file_id (purpose batch_output) and possibly error_file_id are available; `usage` populated (batches created after 2025-09-07).",13   "expired": "Terminal. 24h window elapsed; finished requests are in output_file_id, unfinished ones in error_file_id with code batch_expired. Completed requests are billed.",14   "cancelling": "Cancel requested; in-flight requests finish (up to ~10 min).",15   "cancelled": "Terminal. Partial results (if any) available via output_file_id."16  },17  "initial": "validating",18  "terminal": ["completed", "failed", "expired", "cancelled"],19  "transitions": [20   ["validating", "failed"], ["validating", "in_progress"], ["in_progress", "finalizing"], ["finalizing", "completed"],21   ["in_progress", "expired"], ["validating", "cancelling"], ["in_progress", "cancelling"], ["cancelling", "cancelled"]22  ],23  "timestamps": ["created_at", "in_progress_at", "finalizing_at", "completed_at", "failed_at", "expired_at", "cancelling_at", "cancelled_at", "expires_at"],24  "observed": {25   "2026-09-18 1-request /v1/responses gpt-5.4-nano": "validating (t=0) -> in_progress (t=2s) -> finalizing (t=29s) -> completed (t=30s); usage {input 10, output 5}; output file expires_at = file created_at + output_expires_after.seconds",26   "2026-09-18 bogus input_file_id": "POST accepted (200, status validating) -> failed within ~60s with errors.data[0] = {code:'invalid_request', message:'Cannot find file …, or organization … does not have access to it.', param:'file_id', line:null}"27  },28  "status": ["DOCUMENTED", "LIVE_VERIFIED"],29  "sources": [30   {"url": "https://developers.openai.com/api/docs/guides/batch#4-check-the-status-of-a-batch", "retrieved_at": "2026-09-18"},31   {"url": "https://developers.openai.com/api/reference/resources/batches", "retrieved_at": "2026-09-18"}32  ]33 },34 {35  "provider": "openai",36  "object": "fine_tuning.job",37  "api_family": "fine_tuning",38  "status_field": "status",39  "states": {40   "validating_files": "Training/validation files are checked (format, token counts, moderation of images for vision SFT).",41   "queued": "Waiting for training capacity.",42   "running": "Training loop; events of type `metrics` are emitted per step; checkpoints created per epoch (SFT/DPO) or per validation step (RFT).",43   "succeeded": "Terminal. `fine_tuned_model` is set (ft:<base>:<org>:<suffix>:<id>), result_files available, trained_tokens set.",44   "failed": "Terminal. `error` {code, message, param} explains (e.g. invalid training file, safety-check failure).",45   "cancelled": "Terminal. Cancelled by POST …/cancel.",46   "paused": "RFT only (not in the OpenAPI enum): POST …/pause snapshots a checkpoint and stops; POST …/resume continues from it."47  },48  "initial": "validating_files",49  "terminal": ["succeeded", "failed", "cancelled"],50  "transitions": [51   ["validating_files", "queued"], ["validating_files", "failed"], ["queued", "running"], ["running", "succeeded"], ["running", "failed"],52   ["validating_files", "cancelled"], ["queued", "cancelled"], ["running", "cancelled"], ["running", "paused"], ["paused", "running"], ["paused", "cancelled"]53  ],54  "timestamps": ["created_at", "finished_at", "estimated_finish"],55  "observed": {56   "2026-09-18": "Could not observe: POST /v1/fine_tuning/jobs -> 403 code training_not_available (org not allowed to create jobs; platform winding down). GET list returns empty; bogus ids -> 404 fine_tune_not_found."57  },58  "status": ["DOCUMENTED", "DEPRECATED", "ACCOUNT_RESTRICTED"],59  "sources": [60   {"url": "https://developers.openai.com/api/reference/resources/fine_tuning", "retrieved_at": "2026-09-18"},61   {"url": "https://developers.openai.com/api/docs/guides/reinforcement-fine-tuning#pausing-and-resuming-jobs", "retrieved_at": "2026-09-18"},62   {"url": "https://developers.openai.com/api/docs/deprecations#update-to-openais-self-serve-fine-tuning", "retrieved_at": "2026-09-18"}63  ]64 },65 {66  "provider": "openai",67  "object": "eval.run",68  "api_family": "evals",69  "status_field": "status",70  "states": {71   "queued": "Run accepted; items not yet processed.",72   "in_progress": "Sampling (if data_source is completions/responses) and grading output items.",73   "completed": "Terminal. result_counts {total, errored, failed, passed}, per_testing_criteria_results[], per_model_usage[] (empty array when no sampling) and report_url are final.",74   "failed": "Terminal. `error` {code, message} set.",75   "canceled": "Terminal. Cancelled via POST /v1/evals/{eval_id}/runs/{run_id} (American spelling in the API filter enum)."76  },77  "initial": "queued",78  "terminal": ["completed", "failed", "canceled"],79  "transitions": [["queued", "in_progress"], ["in_progress", "completed"], ["in_progress", "failed"], ["queued", "canceled"], ["in_progress", "canceled"]],80  "output_item_status": {"pass": "all graders passed", "fail": "at least one grader failed"},81  "observed": {82   "2026-09-18 jsonl file_content, 3 items, pre-filled sample, no model sampling": "queued (t=0) -> in_progress (t≈0.3s) -> completed (t≈3.6s); POST cancel on the completed run returned 200 and status stayed completed; GET runs?status=completed lagged (0 items right after completion)."83  },84  "status": ["DOCUMENTED", "DEPRECATED", "LIVE_VERIFIED"],85  "sources": [86   {"url": "https://developers.openai.com/api/reference/resources/evals", "retrieved_at": "2026-09-18"},87   {"url": "https://developers.openai.com/api/docs/guides/evals#analyze-the-results", "retrieved_at": "2026-09-18"}88  ]89 },90 {91  "provider": "openai",92  "object": "vector_store.file",93  "api_family": "vector_stores",94  "status_field": "status",95  "states": {96   "in_progress": "File is being parsed, chunked, embedded and indexed.",97   "completed": "Terminal. Searchable; usage_bytes reflects indexed size (larger than the raw file).",98   "failed": "Terminal. last_error {code: server_error | unsupported_file | invalid_file, message}.",99   "cancelled": "Terminal. Parent file batch was cancelled before this file finished."100  },101  "initial": "in_progress",102  "terminal": ["completed", "failed", "cancelled"],103  "transitions": [["in_progress", "completed"], ["in_progress", "failed"], ["in_progress", "cancelled"]],104  "observed": {"2026-09-18 200-byte txt, static 100/20": "in_progress -> completed after ~7.6s; usage_bytes 1203"},105  "status": ["DOCUMENTED", "LIVE_VERIFIED"],106  "sources": [{"url": "https://developers.openai.com/api/reference/resources/vector_stores/subresources/files", "retrieved_at": "2026-09-18"}]107 },108 {109  "provider": "openai",110  "object": "vector_store.file_batch",111  "api_family": "vector_stores",112  "status_field": "status",113  "states": {114   "in_progress": "Some files still indexing (file_counts.in_progress > 0).",115   "completed": "Terminal. All files reached a terminal state (some may be failed).",116   "failed": "Terminal. Batch-level failure.",117   "cancelled": "Terminal. POST …/cancel; remaining files become cancelled."118  },119  "initial": "in_progress",120  "terminal": ["completed", "failed", "cancelled"],121  "transitions": [["in_progress", "completed"], ["in_progress", "failed"], ["in_progress", "cancelled"]],122  "observed": {"2026-09-18 1 file": "in_progress -> completed after ~4s; POST cancel on the completed batch -> HTTP 500 server_error"},123  "status": ["DOCUMENTED", "LIVE_VERIFIED"],124  "sources": [{"url": "https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches", "retrieved_at": "2026-09-18"}]125 },126 {127  "provider": "openai",128  "object": "vector_store",129  "api_family": "vector_stores",130  "status_field": "status",131  "states": {132   "in_progress": "Files passed at creation (file_ids) are still indexing.",133   "completed": "Ready for search / file_search (an empty store is created directly in this state).",134   "expired": "Terminal. expires_after policy elapsed since last_active_at; all vector_store.file objects deleted, no more storage billing."135  },136  "initial": "completed (no files) | in_progress (with file_ids)",137  "terminal": ["expired"],138  "transitions": [["in_progress", "completed"], ["completed", "in_progress"], ["completed", "expired"]],139  "observed": {"2026-09-18": "created empty -> status completed immediately; expires_at = created_at + days*86400 with anchor last_active_at"},140  "status": ["DOCUMENTED", "LIVE_VERIFIED"],141  "sources": [{"url": "https://developers.openai.com/api/reference/resources/vector_stores", "retrieved_at": "2026-09-18"}, {"url": "https://developers.openai.com/api/docs/guides/retrieval#expiration-policies", "retrieved_at": "2026-09-18"}]142 },143 {144  "provider": "openai",145  "object": "upload",146  "api_family": "uploads",147  "status_field": "status",148  "states": {149   "pending": "Accepting Parts (POST …/parts). Expires one hour after creation (expires_at = created_at + 3600).",150   "completed": "Terminal. POST …/complete succeeded; `file` holds the resulting File object (usable like any uploaded file).",151   "cancelled": "Terminal. POST …/cancel; adding parts afterwards -> 400 'Upload status is already in a cancelled state'.",152   "expired": "Terminal. Not completed within the hour."153  },154  "initial": "pending",155  "terminal": ["completed", "cancelled", "expired"],156  "transitions": [["pending", "completed"], ["pending", "cancelled"], ["pending", "expired"]],157  "observed": {"2026-09-18": "pending -> completed (1 part, 192 bytes, purpose user_data); pending -> cancelled; expires_at observed = created_at + 3600 even when expires_after {seconds: 3600} is passed"},158  "status": ["DOCUMENTED", "LIVE_VERIFIED"],159  "sources": [{"url": "https://developers.openai.com/api/reference/resources/uploads", "retrieved_at": "2026-09-18"}]160 },161 {162  "provider": "openai",163  "object": "file",164  "api_family": "files",165  "status_field": "status (deprecated field)",166  "states": {167   "uploaded": "Legacy: received, not yet processed.",168   "processed": "Legacy: ready. Every file created in the 2026-09-18 tests was returned directly as processed.",169   "error": "Legacy: processing failed (see status_details, also deprecated)."170  },171  "initial": "processed (observed)",172  "terminal": ["processed", "error"],173  "transitions": [["uploaded", "processed"], ["uploaded", "error"]],174  "observed": {"2026-09-18": "status 'processed' immediately for txt/jsonl uploads and for the Upload-completed file; expiry is via expires_at (batch purpose default +30d, else null unless expires_after given)"},175  "status": ["DOCUMENTED", "DEPRECATED", "LIVE_VERIFIED"],176  "sources": [{"url": "https://developers.openai.com/api/reference/resources/files", "retrieved_at": "2026-09-18"}]177 }178]179
Files main
Menu

Theme